PHP 5.4.33 Released

date_default_timezone_get

(PHP 5 >= 5.1.0)

date_default_timezone_get Retorna a timezone (zona de tempo) padrão usada por todas as funções de data e tempo em um script

Descrição

string date_default_timezone_get ( void )

Em ordem de preferência, essa função retorna a timezone padrão por:

  • Lendo a timezone configurada utilizando a função date_default_timezone_set() (se existir)

  • Até o PHP 5.4.0 somente: Lendo a variável de ambiente TZ (se não estiver vazia)

  • Lendo o valor de date.timezone do ini (se configurada)

  • Até o PHP 5.4.0 somente: Perguntando ao sistema operacional (se suportado e permitido pelo SO). Isso usa um algoritmo que tenta adivinhar a timezone. De jeito nenhum isso funcionará corretamente em toda situação. Um aviso é mostrado quando esse estágio é alcançado. Não confie que ele será adivinhado corretamente, e configure date.timezone para a zona correta.

Se nenhuma das opções acima tiverem sucesso, a função date_default_timezone_get() retornará a timezone padrão UTC

Valor Retornado

Retorna uma string.

Changelog

Versão Descrição
5.4.0 A variável de ambiente TZ não é mais utilizada para adivinhar a timezone.
5.4.0 A timezone não é mais adivinhada de informações disponíveis através do sistema operacional já que a timezone adivinhada não é confiável.

Exemplos

Exemplo #1 Lendo a timezone padrão

<?php
date_default_timezone_set
('Europe/London');

if (
date_default_timezone_get()) {
    echo 
'date_default_timezone_set: ' date_default_timezone_get() . '<br />';
}

if (
ini_get('date.timezone')) {
    echo 
'date.timezone: ' ini_get('date.timezone');
}

?>

O exemplo acima irá imprimir algo similar à:

date_default_timezone_set: Europe/London
date.timezone: Europe/London

Exemplo #2 Lendo a abreviação de uma timezone

<?php
date_default_timezone_set
('America/Los_Angeles');
echo 
date_default_timezone_get() . ' => ' date('e') . ' => ' date('T');
?>

O exemplo acima irá imprimir:

America/Los_Angeles => America/Los_Angeles => PST

Veja Também

add a note add a note

User Contributed Notes 6 notes

up
4
glennpratt+php at gmail dot com
3 years ago
In my case, I'm not sure I can guess the correct timezone any better than PHP and it's no where near important enough to nag the user, so...

<?php
// Suppress DateTime warnings
date_default_timezone_set(@date_default_timezone_get());
?>
up
0
Damien dot Garrido dot Work at gmail dot com
2 years ago
To get offset string from offset:

<?php

function timezone_offset_string( $offset )
{
        return
sprintf( "%s%02d:%02d", ( $offset >= 0 ) ? '+' : '-', abs( $offset / 3600 ), abs( $offset % 3600 ) );
}

$offset = timezone_offset_get( new DateTimeZone( 'Pacific/Kiritimati' ), new DateTime() );
echo
"offset: " . timezone_offset_string( $offset ) . "\n";

$offset = timezone_offset_get( new DateTimeZone( 'Pacific/Tahiti' ), new DateTime() );
echo
"offset: " . timezone_offset_string( $offset ) . "\n";
?>

Output:
offset: +14:00
offset: -10:00
up
-2
benrwhite at gmail dot com
1 year ago
For the reason that date_default_timezone_get() throws an error when the timezone isn't set in php.ini and then returns a default chosen by the system (rather than returning false to indicate to the script that a timezone hasn't been set), I've found that the following works when you want a script to detect when the ini value has not been set and want the script itself to choose a default in that case, while still allowing bootstrap scripts to set their own default using date_default_timezone_set().

<?php

set_error_handler
(function ($errno, $errstr){
    throw new
Exception($errstr);
    return
false;
});
try{
   
date_default_timezone_get();
}
catch(
Exception $e){
   
date_default_timezone_set('UTC'); // Sets to UTC if not specified anywhere in .ini
}
restore_error_handler();
up
-2
dohpaz at gmail dot com
7 years ago
date_default_timezone_get() will still emit a warning in E_STRICT if the timezone is not set; either by date_default_timezone_set() or the ini option of date.timezone.

This is probably not a big deal, but I thought I would contribute what I found.
up
-2
bohwaz
1 year ago
Please note that on Debian/Ubuntu this function will return the system timezone defined in /etc/localtime if date.timezone is not defined, even with PHP 5.4+

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673763#10
up
-6
harmor
6 years ago
If you want to get the abbrivation (3 or 4 letter), instead of the long timezone string you can use date('T') function like this:

Input:
date_default_timezone_set('America/Los_Angeles');
echo date_default_timezone_get();
echo ' => '.date('e');
echo ' => '.date('T');

Output:
America/Los_Angeles => America/Los_Angeles => PST
To Top