Interpreta uma string para um valor de horário baseado em campos

# IntlDateFormatter::localtime

# datefmt_localtime

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

IntlDateFormatter::localtime -- datefmt_localtime — Interpreta uma string para um valor de horário baseado em campos

### Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Converte o valor da string para um valor de horário baseado em campos (um array com vários campos), iniciando em offset e consumindo o máximo possível do valor de entrada.

### Parâmetros

`formatter`

  O recurso do formatador

`string`

  A string a ser convertida para um horário

`offset`

  Posição na qual a interpretação da string será iniciada (baseada em zero). Se não ocorrer erros antes que a string seja consumida, offset conterá -1, caso contrário conterá a posição na qual a interpretação terminou. Se offset > strlen(string), a interpretação falha imediatamente.

### Valor Retornado

Array de inteiros compatível com o horário da localidade: contém valor de hora no formato de 24 horas no campo tm_hour, ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de 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 at 4:00:00 PM Pacific Standard Time', $offset);
    echo 'Valor interpretado: ';
    if ($arr) {
        foreach ($arr as $key => $value) {
            echo "$key : $value , ";
        }
    }

    ?>

Exemplo #2 Exemplo OO

    <?php
    $fmt = new IntlDateFormatter(
        'en_US',
        IntlDateFormatter::FULL,
        IntlDateFormatter::FULL,
        'America/Los_Angeles',
        IntlDateFormatter::GREGORIAN
    );
    $arr = $fmt->localtime('Wednesday, December 31, 1969 at 4:00:00 PM Pacific Standard Time', $offset);
    echo 'Valor interpretado: ';
    if ($arr) {
        foreach ($arr as $key => $value) {
            echo "$key : $value , ";
        }
    }

    ?>

O exemplo acima produzirá:

    Valor interpretado: tm_sec : 0 , tm_min : 0 , tm_hour : 16 , tm_year : 69 ,
    tm_mday : 31 , tm_wday : 3 , tm_yday : 365 , tm_mon : 11 , tm_isdst : 0 ,

### Veja Também

- datefmt_create() - Cria um formatador de data
- datefmt_format() - Formata data/horário como uma string
- datefmt_parse() - Interpreta uma string para uma valor de timestamp
- datefmt_get_error_code() - Obtém o código de erro da última operação
- datefmt_get_error_message() - Obtém a mensagem de erro da última operação

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open