PHP 8.4.2 Released!

    IntlDateFormatter::localtime

    datefmt_localtime

    (PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.0)

    IntlDateFormatter::localtime -- datefmt_localtime — 文字列をパースして、フィールドベースの時刻値にする

    説明

    オブジェクト指向型

    public IntlDateFormatter::localtime(string $string, int &$offset = null): array|false

    手続き型

    datefmt_localtime(IntlDateFormatter $formatter, string $string, int &$offset = null): array|false

    文字列 $value を変換し、フィールドベースの時刻値 (各フィールドを含む配列) にします。$parse_pos からパースを開始し、入力値を可能な限り使用します。

    パラメータ

    formatter

    Formatter リソース。

    string

    時間に変換する文字列。

    offset

    $value のパースを開始する位置 (ゼロから数えます)。 $value を処理する前にエラーが発生していない場合は $parse_pos は -1 となります。それ以外の場合はパースが終了した位置となります (そしてエラーが発生します)。 この変数には、パースが失敗した場合にその終了位置が含まれます。 $parse_pos > strlen($value) の場合、パースは即時に失敗します。

    戻り値

    Localtime 互換の、整数値の配列を返します。 tm_hour フィールド内の、24 時間制の時刻の値を含みます。 失敗した場合に false を返します

    例

    例1 datefmt_localtime() の例

    <?php

    $fmt     = datefmt_create(
    'en_US',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'America/Los_Angeles',
    IntlDateFormatter::GREGORIAN
    );
    $arr = datefmt_localtime($fmt, 'Wednesday, December 31, 1969 4:00:00 PM PT', 0);
    echo     'First parsed output is ';
    if (    $arr) {
    foreach (    $arr as $key => $value) {
    echo     "$key : $value , ";
    }
    }

    ?>

    例2 オブジェクト指向の例

    <?php
    $fmt     = new IntlDateFormatter(
    'en_US',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'America/Los_Angeles',
    IntlDateFormatter::GREGORIAN
    );
    $arr = $fmt->localtime('Wednesday, December 31, 1969 4:00:00 PM PT', 0);
    echo     'First parsed output is ';
    if (    $arr) {
    foreach (    $arr as $key => $value) {
    echo     "$key : $value , ";
    }
    }

    ?>

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

    First parsed output is tm_sec : 0 , tm_min : 0 , tm_hour : 16 , tm_year : 1969 , 
tm_mday : 31 , tm_wday : 4 , tm_yday : 365 , tm_mon : 11 , tm_isdst : 0 ,

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    0
    Patanjali
    7 years ago
    Learning lesson here: Never trust the PHP documentation. Test everything!

    $position does not work as described, at least in PHP 7. After parsing without errors, it does not contain -1.

    You can still use it to set the parsing start character position, but not necessarily whether any errors occurred.

    To test for errors, replace my $nPosition test code in the other note with:
    <?php
    // Check if errors
    $bError = intl_is_failure(datefmt_get_error_code(oIDF));

    // If no error
    if(!$bError){
    // Use 'tm_hour' and 'tm_min' from the $aTime array for checking against other time values
    ...
    }else{
    // Invalid string
    ...
    }
    ?>
    up
    0
    Patanjali
    7 years ago
    You can use datefmt_localtime to convert a user's time string, input using their locale's script, into standard numbers for checking, using a simple HTML input element.

    This avoids using clunky HTML select elements formatted with hour and minute options in the locale's script to capture user input.

    <?php
    // Specify locale of user
    $sLocale = 'en-us'; // US English user
    $sLocale = 'ar-ye'; // Yemen Arab user

    // Create a date formatter for the user's locale
    $oIDF = datefmt_create($sLocale, IntlDateFormatter::NONE, IntlDateFormatter::SHORT);

    // Simulate a user's time input string
    $sTime = datefmt_format($oIDF, ['tm_hour'=>15, 'tm_min'=>25]);
    // For a US English user, $sTime = '3:25 PM'
    // For a Yemen Arab user, $sTime = '٣:٢٥ م'

    // Specify datefmt_locale parsing start at the beginning of the user input
    $nPosition = 0;

    // Convert input time string to array of standard numeric values, as per localtime() output (http://php.net/manual/en/function.localtime.php)
    $aTime = datefmt_localtime($oIDF, $sTime, $nPosition);
    // If no errors, $nPosition set to -1 after parsing, else character position of error

    // If valid string
    if($nPosition = -1){
    // Use 'tm_hour' and 'tm_min' from the $aTime array for checking against other time values
    ...
    }else{
    // Invalid string
    ...
    }
    ?>
    ＋add a note
    To Top