PHP Conference Nagoya 2025

DateTimeZone::getTransitions

timezone_transitions_get

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

DateTimeZone::getTransitions -- timezone_transitions_getRetorna todas as transições para o fuso horário

Descrição

Estilo orientado a objetos

public DateTimeZone::getTransitions(int $timestampBegin = PHP_INT_MIN, int $timestampEnd = PHP_INT_MAX): array|false

Estilo procedural

timezone_transitions_get(DateTimeZone $object, int $timestampBegin = PHP_INT_MIN, int $timestampEnd = PHP_INT_MAX): array|false

Parâmetros

object

Somente no estilo procedural: Um objeto DateTimeZone retornado por timezone_open()

timestampBegin

Timestamp inicial.

timestampEnd

Timestamp final.

Valor Retornado

Retorna um array numericamente indexado de arrays de transições em caso de sucesso, ou false em caso de falha. Objetos DataTimeZone do tipo 1 (deslocamento UTC) e tipo 2 (abreviações) não contêm transições, e se tiverem este método chamado irão retornar false.

Se o parâmetro timestampBegin for informado, a primeira entrada no array de retorno irá contrer um elemento de transição no horário de timestampBegin.

Estrutura do Array de Transição
Key Type Description
ts int Timestamp Unix
time string string de horário DateTimeInterface::ISO8601_EXPANDED (PHP 8.2 e seguintes), ou DateTimeInterface::ISO8601 (PHP 8.1 e anteriores)
offset int Deslocamento UTC em segundos
isdst bool Se o horário de verão está ativo
abbr string Abreviação do fuso horário

Exemplos

Exemplo #1 Exemplo do método timezone_transitions_get()

<?php
$timezone
= new DateTimeZone("Europe/London");
$transitions = $timezone->getTransitions();
print_r(array_slice($transitions, 0, 3));
?>

O exemplo acima produzirá algo semelhante a:

Array
(
    [0] => Array
        (
            [ts] => -9223372036854775808
            [time] => -292277022657-01-27T08:29:52+0000
            [offset] => 3600
            [isdst] => 1
            [abbr] => BST
        )

    [1] => Array
        (
            [ts] => -1691964000
            [time] => 1916-05-21T02:00:00+0000
            [offset] => 3600
            [isdst] => 1
            [abbr] => BST
        )

    [2] => Array
        (
            [ts] => -1680472800
            [time] => 1916-10-01T02:00:00+0000
            [offset] => 0
            [isdst] =>
            [abbr] => GMT
        )

)

Exemplo #2 Um exemplo da função timezone_transitions_get() com o parâmetro timestampBegin

<?php
$timezone
= new DateTimeZone("Europe/London");
$transitions = $timezone->getTransitions(time());
print_r(array_slice($transitions, 0, 3));
?>

O exemplo acima produzirá algo semelhante a:

Array
(
    [0] => Array
        (
            [ts] => 1654184161
            [time] => 2022-06-02T15:36:01+0000
            [offset] => 3600
            [isdst] => 1
            [abbr] => BST
        )

    [1] => Array
        (
            [ts] => 1667091600
            [time] => 2022-10-30T01:00:00+0000
            [offset] => 0
            [isdst] =>
            [abbr] => GMT
        )

    [2] => Array
        (
            [ts] => 1679792400
            [time] => 2023-03-26T01:00:00+0000
            [offset] => 3600
            [isdst] => 1
            [abbr] => BST
        )

)

adicione uma nota

Notas Enviadas por Usuários (em inglês)

Não há notas de usuários para esta página.
To Top