IntlCalendar::getMinimalDaysInFirstWeek

(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)

IntlCalendar::getMinimalDaysInFirstWeek — 特定の年や月における、最初の週の日数の最小値を返す

説明

オブジェクト指向型

public IntlCalendar::getMinimalDaysInFirstWeek(): int|false

手続き型

intlcal_get_minimal_days_in_first_week(IntlCalendar $calendar): int|false

特定の年や月が持たなければならない、 最初の週の日数の最小値を返します。 たとえば、グレゴリオ暦においてこの値が1の場合、 その年の最初の週には1月1日が含まれます。 一方で、この値を7にすると、1月1日はその週の曜日が IntlCalendar::getFirstDayOfWeek() が返した曜日と一致する場合のみ、最初の週になります。 そうでない場合、前年の最後の週として扱われます。

パラメータ

calendar

IntlCalendar クラスのインスタンス。

戻り値

日数を示す数値を返します。 失敗した場合に false を返します

例

例1 IntlCalendar::getMinimalDaysInFirstWeek()

<?php
ini_set('date.timezone', 'UTC');
ini_set('intl.default_locale', 'en_US');

$cal = new IntlGregorianCalendar(2013, 0 /* January */, 2);
var_dump(IntlDateFormatter::formatObject($cal, 'cccc')); // Wednesday

var_dump($cal->getMinimalDaysInFirstWeek(), // 1
$cal->getFirstDayofWeek()); // 1 (Sunday)

// Week 1 of 2013
var_dump(IntlDateFormatter::formatObject($cal, "'Week 'w' of 'Y"));

$cal->setMinimalDaysInFirstWeek(4);
// Still Week 1 of 2013 (1st week has 5 days in the new year)
var_dump(IntlDateFormatter::formatObject($cal, "'Week 'w' of 'Y"));

$cal->setMinimalDaysInFirstWeek(6);
// Week 53 of 2012
var_dump(IntlDateFormatter::formatObject($cal, "'Week 'w' of 'Y"));

上の例の出力は以下となります。

string(9) "Wednesday"
int(1)
int(1)
string(14) "Week 1 of 2013"
string(14) "Week 1 of 2013"
string(15) "Week 53 of 2012"

関連キーワード: 　最初, IntlCalendar, 日数, 特定, 最小, 月, 週, 年, int, string