IntlCalendar クラス
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
はじめに
クラス概要
$timezone
= null
, ?string $locale
= null
): ?IntlCalendar$keyword
, string $locale
, bool $onlyCommon
): IntlIterator|falseint
$year
,int
$month
,int
$dayOfMonth
= NULL,int
$hour
= NULL,int
$minute
= NULL,int
$second
= NULL): true
定義済み定数
IntlCalendar::FIELD_ERA
-
カレンダーのフィールドで、時代を表す数値です。たとえば、グレゴリオ暦やユリウス暦の場合は
1
が紀元後そして0
が紀元前を表します。 また、和暦の場合は235
が平成を表します。 すべてのカレンダーが複数の時代を持つわけではありません。 IntlCalendar::FIELD_YEAR
-
カレンダーの、年を表すフィールド。時代が違えば同じ数字になることもあります。 そのカレンダー型が複数の時代を持っている場合は、このフィールドの最小値は通常は
1
になります。 IntlCalendar::FIELD_MONTH
-
カレンダーの、月を表すフィールド。月番号はゼロからはじまるので、1月が
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
は、ある月の最初の (day of week in month の値が1
となる) 七日間の直前の七日間を表します。 負の値を指定した場合は、月末から数えます。-1
は、その曜日が当月の最後に登場する日付、-2
はさらにその一週間前といったようになります。IntlCalendar::FIELD_WEEK_OF_MONTH
やIntlCalendar::FIELD_WEEK_OF_YEAR
とは異なり、この値は IntlCalendar::getFirstDayOfWeek() や IntlCalendar::getMinimalDaysInFirstWeek() に依存しません。 第一月曜日は第一月曜日であり、たとえ前月に属する日であってもそれは変わりません。 IntlCalendar::FIELD_AM_PM
-
カレンダーの、午前 (
0
) か午後 (1
) かを表すフィールド。 深夜 0 時は午前、正午は午後となります。 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
-
カレンダーの、ローカライズした曜日を表すフィールド。
1
から7
までの値となり、1
は IntlCalendar::getFirstDayOfWeek() が返す値にマッチする曜日に使います。 IntlCalendar::FIELD_EXTENDED_YEAR
-
カレンダーの、年番号を表すフィールド。この番号は、時代をまたがって続きます。 グレゴリオ暦の場合、紀元後の年についてはこの値は
IntlCalendar::FIELD_YEAR
に一致します。 紀元前y
年の場合は-y + 1
となります。 IntlCalendar::FIELD_JULIAN_DAY
-
カレンダーの、ユリウス日を表すフィールド。 一般的な慣習とは違って、このユリウス日は現地時間の深夜 0 時に加算されます。 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
までの値となります。この値は、その日の中での経過ミリ秒数ではありません。 というのも、夏時間への移行を挟む場合はこの値は連続した値にならないからです。 IntlCalendar::FIELD_IS_LEAP_MONTH
-
カレンダーのフィールドで、値が
1
のときはうるう月、0
の場合はそうでないことを表します。 IntlCalendar::FIELD_FIELD_COUNT
-
フィールドの総数。
IntlCalendar::FIELD_DAY_OF_MONTH
IntlCalendar::DOW_SUNDAY
-
日曜日。
IntlCalendar::DOW_MONDAY
-
月曜日。
IntlCalendar::DOW_TUESDAY
-
火曜日。
IntlCalendar::DOW_WEDNESDAY
-
水曜日。
IntlCalendar::DOW_THURSDAY
-
木曜日。
IntlCalendar::DOW_FRIDAY
-
金曜日。
IntlCalendar::DOW_SATURDAY
-
土曜日。
IntlCalendar::DOW_TYPE_WEEKDAY
-
平日であることを示す IntlCalendar::getDayOfWeekType() の出力。
IntlCalendar::DOW_TYPE_WEEKEND
-