Internationalization IntlCalendar 클래스
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
소개
클래스 개요
class IntlCalendar { /* Constants */ const int FIELD_ERA = 0; const int FIELD_YEAR = 1; const int FIELD_MONTH = 2; const int FIELD_WEEK_OF_YEAR = 3; const int FIELD_WEEK_OF_MONTH = 4; const int FIELD_DATE = 5; const int FIELD_DAY_OF_YEAR = 6; const int FIELD_DAY_OF_WEEK = 7; const int FIELD_DAY_OF_WEEK_IN_MONTH = 8; const int FIELD_AM_PM = 9; const int FIELD_HOUR = 10; const int FIELD_HOUR_OF_DAY = 11; const int FIELD_MINUTE = 12; const int FIELD_SECOND = 13; const int FIELD_MILLISECOND = 14; const int FIELD_ZONE_OFFSET = 15; const int FIELD_DST_OFFSET = 16; const int FIELD_YEAR_WOY = 17; const int FIELD_DOW_LOCAL = 18; const int FIELD_EXTENDED_YEAR = 19; const int FIELD_JULIAN_DAY = 20; const int FIELD_MILLISECONDS_IN_DAY = 21; const int FIELD_IS_LEAP_MONTH = 22; const int FIELD_FIELD_COUNT = 23; const int FIELD_DAY_OF_MONTH = 5; const int DOW_SUNDAY = 1; const int DOW_MONDAY = 2; const int DOW_TUESDAY = 3; const int DOW_WEDNESDAY = 4; const int DOW_THURSDAY = 5; const int DOW_FRIDAY = 6; const int DOW_SATURDAY = 7; const int DOW_TYPE_WEEKDAY = 0; const int DOW_TYPE_WEEKEND = 1; const int DOW_TYPE_WEEKEND_OFFSET = 2; const int DOW_TYPE_WEEKEND_CEASE = 3; const int WALLTIME_FIRST = 1; const int WALLTIME_LAST = 0; const int WALLTIME_NEXT_VALID = 2; /* Methods */ private __construct() public add(int $field, int $value): bool public after(IntlCalendar $other): bool public before(IntlCalendar $other): bool public clear(?int $field = null): bool public static createInstance(IntlTimeZone|DateTimeZone|string|null $timezone = null, ?string $locale = null): ?IntlCalendar public equals(IntlCalendar $other): bool public fieldDifference(float $timestamp, int $field): int|false public static fromDateTime(DateTime|string $datetime, ?string $locale = null): ?IntlCalendar public get(int $field): int|false public getActualMaximum(int $field): int|false public getActualMinimum(int $field): int|false public static getAvailableLocales(): array public getDayOfWeekType(int $dayOfWeek): int|false public getErrorCode(): int|false public getErrorMessage(): string|false public getFirstDayOfWeek(): int|false public getGreatestMinimum(int $field): int|false public static getKeywordValuesForLocale(string $keyword, string $locale, bool $onlyCommon): IntlIterator|false public getLeastMaximum(int $field): int|false public getLocale(int $type): string|false public getMaximum(int $field): int|false public getMinimalDaysInFirstWeek(): int|false public getMinimum(int $field): int|false public static getNow(): float public getRepeatedWallTimeOption(): int public getSkippedWallTimeOption(): int public getTime(): float|false public getTimeZone(): IntlTimeZone|false public getType(): string public getWeekendTransition(int $dayOfWeek): int|false public inDaylightTime(): bool public isEquivalentTo(IntlCalendar $other): bool public isLenient(): bool public isSet(int $field): bool public isWeekend(?float $timestamp = null): bool public roll(int $field, int|bool $value): bool public set(int $field, int $value): bool public set( int $year, int $month, int $dayOfMonth = NULL, int $hour = NULL, int $minute = NULL, int $second = NULL ): bool public setFirstDayOfWeek(int $dayOfWeek): bool public setLenient(bool $lenient): bool public setMinimalDaysInFirstWeek(int $days): bool public setRepeatedWallTimeOption(int $option): bool public setSkippedWallTimeOption(int $option): bool public setTime(float $timestamp): bool public setTimeZone(IntlTimeZone|DateTimeZone|string|null $timezone): bool public toDateTime(): DateTime|false }
미리 정의된 상수
IntlCalendar::FIELD_ERA
- 연대를 숫자로 나타내는 달력 필드입니다. 예를 들어 그레고리력/율리우스력의 경우
1
, BC의 경우0
, 일본 달력의 헤이세이(平成) 시대는235
입니다. 모든 달력에 하나 이상의 연대가 있는 것은 아닙니다. IntlCalendar::FIELD_YEAR
- 연도의 달력 필드입니다. 이것은 시대를 초월한 독특한 것이 아닙니다. 달력 유형에 하나 이상의 연대가 있는 경우 일반적으로 이 필드의 최소값은
1
입니다. IntlCalendar::FIELD_MONTH
- 해당 월의 달력 필드입니다. 월 순서는 0을 기준으로 하므로 1월(여기에서는 달력의 첫 번째 달을 나타내는 데 사용됨, 이슬람 달력에서 Muharram과 같은 다른 이름으로 불릴 수 있음)은
0
으로, 2월은1
로, ..., 12월은 다음으로 표시됩니다.11
및 달력이 있는 경우 13일 또는 윤월은12
까지입니다. IntlCalendar::FIELD_WEEK_OF_YEAR
- 해당 연도의 주 번호에 대한 달력 필드입니다. 이것은 주의 시작으로 간주되는 요일과 한 주의 최소 일 수에 따라 다릅니다.
IntlCalendar::FIELD_WEEK_OF_MONTH
- 해당 월의 주 번호에 대한 달력 필드입니다. 이것은 주의 시작으로 간주되는 요일과 한 주의 최소 일 수에 따라 다릅니다.
IntlCalendar::FIELD_DATE
- 해당 월의 달력 필드입니다. 이름이 더 명확한
IntlCalendar::FIELD_DAY_OF_MONTH
와 동일합니다. IntlCalendar::FIELD_DAY_OF_YEAR
- 올해의 달력 필드입니다. 그레고리력의 경우
1
로 시작하여365
또는366
으로 끝납니다. IntlCalendar::FIELD_DAY_OF_WEEK
- 요일의 달력 필드입니다. 해당 값은
1
(일요일,IntlCalendar::DOW_SUNDAY
및 후속 상수 참조)로 시작하고 마지막 유효한 값은 7(토요일)입니다. IntlCalendar::FIELD_DAY_OF_WEEK_IN_MONTH
- 요일(일요일, 월요일, ...)이 주어지면 이 달력 필드는 특정 월의 해당 요일에 서수를 할당합니다. 따라서 이 필드의 값이
1
이고 요일의 값이2
(월요일)이면 해당 월의 설정일은 해당 월의 첫 번째 월요일입니다. 최대값은5
입니다.또한 값
0
과 음수 값도 허용됩니다. 값0
은 한 달의 처음 7일 직전에 발생하는 7일을 포함합니다(따라서 값이1
인 '요일'을 가짐). 음수 값은 월말부터 계산을 시작합니다.-1
은 해당 월의 마지막 요일을 가리키고-2
는 마지막 두 번째 날짜를 가리킵니다.IntlCalendar::FIELD_WEEK_OF_MONTH
및IntlCalendar::FIELD_WEEK_OF_YEAR
와 달리 이 값은 IntlCalendar::getFirstDayOfWeek() 또는 IntlCalendar::getMinimalDaysInFirstWeek()에 종속되지 않습니다. 첫 번째 월요일은 이전 달에 속하는 주에 있더라도 첫 번째 월요일입니다. IntlCalendar::FIELD_AM_PM
- 시간이 정오 이전(값
0
, AM)인지 또는 이후(1
)인지를 나타내는 달력 필드입니다. 자정은 AM, 정오는 PM입니다. IntlCalendar::FIELD_HOUR
- 오전인지 오후인지 지정하지 않고 시간에 대한 달력 필드입니다. 유효한 값은
0
~11
입니다. IntlCalendar::FIELD_HOUR_OF_DAY
- 하루의 전체(24시간) 시간에 대한 달력 필드입니다. 유효한 값은
0
~23
입니다. IntlCalendar::FIELD_MINUTE
- 시간의 분 구성요소에 대한 달력 필드입니다.
IntlCalendar::FIELD_SECOND
- 시간의 초 구성 요소에 대한 달력 필드입니다.
IntlCalendar::FIELD_MILLISECOND
- 달력 필드는 시간의 밀리초 구성요소입니다.
IntlCalendar::FIELD_ZONE_OFFSET
- 표준 시간대의 원시 오프셋을 나타내는 달력 필드(밀리초)입니다. 원시 오프셋은 일광 절약 시간제로 인한 오프셋을 제외한 시간대 오프셋입니다.
IntlCalendar::FIELD_DST_OFFSET
- 달력 시간에 대해 활성화된 경우 달력 시간대의 일광 절약 시간 오프셋에 대한 달력 필드(밀리초)입니다.
IntlCalendar::FIELD_YEAR_WOY
- week of year 목적으로 연도를 나타내는 달력 필드입니다.
IntlCalendar::FIELD_DOW_LOCAL
- 현지화된 요일의 달력 필드입니다. IntlCalendar::getFirstDayOfWeek()에서 반환된 값과 일치하는 요일에
1
이 사용되는1
에서7
사이의 값입니다. IntlCalendar::FIELD_EXTENDED_YEAR
- 여러 시대에 걸쳐 연속적인 연도 숫자 표현을 위한 달력 필드입니다. 그레고리력의 경우 이 필드의 값은 AD 연도의 경우
IntlCalendar::FIELD_YEAR
의 값과 일치합니다. BC 연도y
는-y + 1
로 표시됩니다. IntlCalendar::FIELD_JULIAN_DAY
- 수정된 율리우스력 일수에 대한 달력 필드입니다. UTC 정오가 아닌 로컬 영역 자정에 전환이 발생한다는 점에서 기존의 율리우스력 일 수와 다릅니다. 날짜를 고유하게 식별합니다.
IntlCalendar::FIELD_MILLISECONDS_IN_DAY
IntlCalendar::FIELD_HOUR_OF_DAY
,IntlCalendar::FIELD_MINUTE
,IntlCalendar::FIELD_SECOND
및IntlCalendar::FIELD_MILLISECOND
의 정보를 포함하는 달력 필드입니다. 범위는0
~24 * 3600 * 1000 - 1
입니다. DST 전환 시 벽 시간과 유사한 불연속성을 갖게 되므로 하루에 경과된 시간(밀리초)이 아닙니다.IntlCalendar::FIELD_IS_LEAP_MONTH
- 윤월을 나타내는 경우 값이
1
이고 그렇지 않은 경우0
인 달력 필드입니다. IntlCalendar::FIELD_FIELD_COUNT
- 총 필드 수입니다.
IntlCalendar::FIELD_DAY_OF_MONTH
IntlCalendar::FIELD_DATE
의 별칭입니다.IntlCalendar::DOW_SUNDAY
- Sunday.
IntlCalendar::DOW_MONDAY
- Monday.
IntlCalendar::DOW_TUESDAY
- Tuesday.
IntlCalendar::DOW_WEDNESDAY
- Wednesday.
IntlCalendar::DOW_THURSDAY
- Thursday.
IntlCalendar::DOW_FRIDAY
- Friday.
IntlCalendar::DOW_SATURDAY
- Saturday.
IntlCalendar::DOW_TYPE_WEEKDAY
- 요일이 요일임을 나타내는 IntlCalendar::getDayOfWeekType()의 출력입니다.
IntlCalendar::DOW_TYPE_WEEKEND
- 요일이 주말에 속함을 나타내는 IntlCalendar::getDayOfWeekType()의 출력입니다.
IntlCalendar::DOW_TYPE_WEEKEND_OFFSET
- 주말이 지정된 요일에 시작됨을 나타내는 IntlCalendar::getDayOfWeekType()의 출력입니다.
IntlCalendar::DOW_TYPE_WEEKEND_CEASE
- 주말이 지정된 요일에 종료됨을 나타내는 IntlCalendar::getDayOfWeekType()의 출력입니다.
IntlCalendar::WALLTIME_FIRST
- IntlCalendar::getSkippedWallTimeOption()의 출력은 건너뛴 범위의 실제 시간이 실제 시간과 1시간이 적은 동일한 순간을 참조해야 함을 나타내고 IntlCalendar::getRepeatedWallTimeOption()의 출력은 반복된 범위의 실제 시간을 참조해야 함을 나타냅니다. 이러한 벽 시간의 첫 번째 발생.
IntlCalendar::WALLTIME_LAST
- IntlCalendar::getSkippedWallTimeOption()의 출력은 건너뛴 범위의 실제 시간이 1시간 후의 실제 시간과 동일한 순간을 참조해야 함을 나타내고 IntlCalendar::getRepeatedWallTimeOption()의 출력은 반복된 범위의 실제 시간을 참조해야 함을 나타냅니다. 이러한 벽 시간의 두 번째 발생.
IntlCalendar::WALLTIME_NEXT_VALID
- IntlCalendar::getSkippedWallTimeOption()의 출력은 건너뛴 범위의 벽 시간이 일광 절약 시간 전환이 발생(시작)되는 순간을 참조해야 함을 나타냅니다.
목차
- IntlCalendar::add — 필드에 (서명된) 시간 추가
- IntlCalendar::after — 이 객체의 시간이 전달된 객체의 시간 이후인지 여부
- IntlCalendar::before — 이 객체의 시간이 전달된 객체의 시간 이전인지 여부
- IntlCalendar::clear — 필드 또는 모든 필드 지우기
- IntlCalendar::__construct — 인스턴스화를 허용하지 않는 개인 생성자
- IntlCalendar::createInstance — 새 IntlCalendar 만들기
- IntlCalendar::equals — 동일한지 두 IntlCalendar 개체의 시간 비교
- IntlCalendar::fieldDifference — 주어진 시간과 이 객체의 시간의 차이 계산
- IntlCalendar::fromDateTime — DateTime 개체 또는 문자열에서 IntlCalendar 만들기
- IntlCalendar::get — 필드 값 가져오기
- IntlCalendar::getActualMaximum — 객체의 현재 시간을 고려한 필드의 최대값
- IntlCalendar::getActualMinimum — 객체의 현재 시간을 고려한 필드의 최소값
- IntlCalendar::getAvailableLocales — 데이터가 있는 로케일 배열 가져오기
- IntlCalendar::getDayOfWeekType — 하루가 평일인지 주말인지 아니면 둘 사이에 전환이 있는 날인지 알려주세요.
- IntlCalendar::getErrorCode — 개체에 대한 마지막 오류 코드 가져오기
- IntlCalendar::getErrorMessage — 개체에 대한 마지막 오류 메시지 가져오기
- IntlCalendar::getFirstDayOfWeek — 캘린더 로케일의 첫 번째 요일 가져오기
- IntlCalendar::getGreatestMinimum — 필드의 최대 로컬 최소값 가져오기
- IntlCalendar::getKeywordValuesForLocale — 로케일 키워드 값 세트 가져오기
- IntlCalendar::getLeastMaximum — 필드에 대한 최소 로컬 최대값 가져오기
- IntlCalendar::getLocale — 개체와 연결된 로케일 가져오기
- IntlCalendar::getMaximum — 필드의 전역 최대값 가져오기
- IntlCalendar::getMinimalDaysInFirstWeek — 1년 또는 월의 첫 번째 주가 가질 수 있는 최소 일수를 가져옵니다.
- IntlCalendar::getMinimum — 필드의 전역 최소값 가져오기
- IntlCalendar::getNow — 현재 시간을 나타내는 숫자 가져오기
- IntlCalendar::getRepeatedWallTimeOption — 반복되는 벽 시간을 처리하기 위한 동작 가져오기
- IntlCalendar::getSkippedWallTimeOption — 건너뛴 벽 시간을 처리하기 위한 동작 가져오기
- IntlCalendar::getTime — 현재 개체가 나타내는 시간 가져오기
- IntlCalendar::getTimeZone — 개체의 시간대 가져오기
- IntlCalendar::getType — 캘린더 유형 가져오기
- IntlCalendar::getWeekendTransition — 주말이 시작되거나 끝나는 시간 가져오기
- IntlCalendar::inDaylightTime — 개체의 시간이 일광 절약 시간인지 여부
- IntlCalendar::isEquivalentTo — 다른 캘린더가 동일하지만 다른 시간인지 여부
- IntlCalendar::isLenient — 날짜/시간 해석이 관대 모드인지 여부
- IntlCalendar::isSet — 필드 설정 여부
- IntlCalendar::isWeekend — 특정 날짜/시간이 주말인지 여부
- IntlCalendar::roll — 더 중요한 필드로 옮기지 않고 필드에 가치 추가
- IntlCalendar::set — 한 번에 시간 필드 또는 여러 공통 필드 설정
- IntlCalendar::setFirstDayOfWeek — 한 주의 시작으로 간주되는 요일 설정
- IntlCalendar::setLenient — 날짜/시간 해석의 관대함 여부 설정
- IntlCalendar::setMinimalDaysInFirstWeek — 1년 또는 월의 첫 번째 주가 가질 수 있는 최소 일 수를 설정합니다.
- IntlCalendar::setRepeatedWallTimeOption — 음수 시간대 오프셋 전환에서 반복되는 벽 시간을 처리하기 위한 동작 설정
- IntlCalendar::setSkippedWallTimeOption — 양수 시간대 오프셋 전환에서 건너뛴 벽 시간을 처리하기 위한 동작 설정
- IntlCalendar::setTime — 에포크 이후의 달력 시간을 밀리초 단위로 설정합니다.
- IntlCalendar::setTimeZone — 이 캘린더에서 사용하는 시간대 설정
- IntlCalendar::toDateTime — IntlCalendar를 DateTime 개체로 변환