IntlDateFormatter::localtime

datefmt_localtime

Parse string to a field-based time value

&reftitle.description;

&style.oop;

public ``array``false```IntlDateFormatter::localtime` `string` `string` `int` `offset`&null;

&style.procedural;

``array``false```datefmt_localtime` `IntlDateFormatter` `formatter` `string` `string` `int` `offset`&null;

Converts string $value to a field-based time value ( an array of various fields), starting at $parse_pos and consuming as much of the input value as possible.

&reftitle.parameters;

`formatter`

- The formatter resource

`string`

- string to convert to a time

`offset`

- Position at which to start the parsing in $value (zero-based). If no error occurs before $value is consumed, $parse_pos will contain -1 otherwise it will contain the position at which parsing ended . If $parse_pos > strlen($value), the parse fails immediately.

&reftitle.returnvalues;

Localtime compatible array of integers : contains 24 hour clock value in tm_hour field, &return.falseforfailure;.

&reftitle.examples;

### `datefmt_localtime` example

    <?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 , ";
        }
    }

    ?>

### OO example

    <?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 , ";
        }
    }

    ?>

&example.outputs;

    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 ,

&reftitle.seealso;

- `datefmt_create`
- `datefmt_format`
- `datefmt_parse`
- `datefmt_get_error_code`
- `datefmt_get_error_message`