Funções de Data e hora
Introdução
Estas funções te permitem conseguir a data e a hora do servidor onde o PHP está rodando. Você pode usar estas funções para formatar a saída de data e hora de muitas maneiras diferentes.
Nota: Por favor mantenha em mente que estas funções dependem das configurações locais do servidor. Considerar especialmente horário-de-verão (use e.g. $date = strtotime('+7 days', $date) e não $date += 7*24*60*60) e anos bissextos quando trabalhar com estas funções.
Nota: Os timezones referenciados nesta seção podem ser encontrados em List of Supported Timezones.
Dependências
Nenhuma biblioteca externa é necessária para compilar esta extensão.
Instalação
Não há nenhuma instalação necessária para utilizar estas funções, elas fazem parte do núcleo do PHP.
Nota: A última versão do banco de dados de timezone pode ser instalado via » timezonedb da PECL. Para usuários Windows, uma pré-compilada DLL pode ser obtida pelo site da PECL4Win: » php_timezonedb.dll.
Configurações em execução
O comportamento dessas funções podem ser modificado pelas configurações do php.ini.
| Nome | Valor Padrão | Alterável | Changelog |
|---|---|---|---|
| date.default_latitude | "31.7667" | PHP_INI_ALL | Disponível desde o PHP 5.0.0. |
| date.default_longitude | "35.2333" | PHP_INI_ALL | Disponível desde o PHP 5.0.0. |
| date.sunrise_zenith | "90.583333" | PHP_INI_ALL | Disponível desde o PHP 5.0.0. |
| date.sunset_zenith | "90.583333" | PHP_INI_ALL | Disponível desde o PHP 5.0.0. |
| date.timezone | "" | PHP_INI_ALL | Disponível desde o PHP 5.1.0. |
Breve descrição das diretivas de configuração.
- date.default_latitude float
-
A latitude padrão.
- date.default_longitude float
-
A longitude padrão.
- date.sunrise_zenith float
-
O zenith do nascer do sol padrão.
- date.sunset_zenith float
-
O zenith do pôr-do-sol padrão.
- date.timezone string
-
A zona horária padrão usada por todas as funções de data/hora se a variável de ambiente TZ não existir. A ordem de precedência é descrita na página da função date_default_timezone_get(). Veja List of Supported Timezones para uma lista de zonas horárias suportadas.
Nota: As primeiras quatro opções de configuração são usadas atualmente por date_sunrise() e date_sunset().
Tipos Resource
Esta extensão não possui nenhum tipo resource.
Constantes pré-definidas
As seguintes constantes são definidas desde o PHP 5.1.1 e oferecem representações padrão de datas, que podem ser usadas com funções de formatação de datas (como date()).
- DATE_ATOM (string)
- Atom (exemplo: 2005-08-15T15:52:01+00:00)
- DATE_COOKIE (string)
- HTTP Cookies (exemplo: Monday, 15-Aug-05 15:52:01 UTC)
- DATE_ISO8601 (string)
- ISO-8601 (exemplo: 2005-08-15T15:52:01+0000)
- DATE_RFC822 (string)
- RFC 822 (exemplo: Mon, 15 Aug 05 15:52:01 +0000)
- DATE_RFC850 (string)
- RFC 850 (exemplo: Monday, 15-Aug-05 15:52:01 UTC)
- DATE_RFC1036 (string)
- RFC 1036 (exemplo: Mon, 15 Aug 05 15:52:01 +0000)
- DATE_RFC1123 (string)
- RFC 1123 (exemplo: Mon, 15 Aug 2005 15:52:01 +0000)
- DATE_RFC2822 (string)
- RFC 2822 (Mon, 15 Aug 2005 15:52:01 +0000)
- DATE_RFC3339 (string)
- O mesmo que DATE_ATOM (a partir do PHP 5.1.3)
- DATE_RSS (string)
- RSS (Mon, 15 Aug 2005 15:52:01 +0000)
- DATE_W3C (string)
- World Wide Web Consortium (exemplo: 2005-08-15T15:52:01+00:00)
As seguintes constantes existem desde o PHP 5.1.2 e especificam o formato retornado pelas funções date_sunrise() e date_sunset().
Índice
- checkdate — Validar uma data Gregoriana
- date_create — Retorna um novo objeto DateTime
- date_date_set — Define a data
- date_default_timezone_get — Gets the default timezone used by all date/time functions in a script
- date_default_timezone_set — Sets the default timezone used by all date/time functions in a script
- date_format — Retorna a data formatada de acordo com o formato dado
- date_isodate_set — Define a data ISO
- date_modify — Altera o timestamp
- date_offset_get — Returns the daylight saving time offset
- date_parse — Retorna um array associativo com detalhes sobre uma dada data
- date_sun_info — Returns an array with information about sunset/sunrise and twilight begin/end
- date_sunrise — Returns time of sunrise for a given day and location
- date_sunset — Returns time of sunset for a given day and location
- date_time_set — Define o tempo
- date_timezone_get — Return time zone relative to given DateTime
- date_timezone_set — Sets the time zone for the DateTime object
- date — Formata a data e a hora local
- getdate — Consegue informações data/hora
- gettimeofday — Obtém a hora local
- gmdate — Formata uma data/hora GMT/CUT
- gmmktime — Obtém um timestamp Unix para uma data GMT
- gmstrftime — Formata uma hora/data GMT/CUT de acordo com as configurações locais
- idate — Format a local time/date as integer
- localtime — Obtém a hora local
- microtime — Retorna um timestamp Unix com microsegundos
- mktime — Obtém um timestamp Unix para uma data
- strftime — Formata uma hora/data de acordo com as configurações locais
- strptime — Parse a time/date generated with strftime
- strtotime — Analisa qualquer descrição em texto em inglês de data hora em timestamp Unix
- time — Retorna o timestamp Unix atual
- timezone_abbreviations_list — Returns associative array containing dst, offset and the timezone name
- timezone_identifiers_list — Returns numerically index array with all timezone identifiers
- timezone_name_from_abbr — Returns the timezone name from abbrevation
- timezone_name_get — Returns the name of the timezone
- timezone_offset_get — Returns the timezone offset from GMT
- timezone_open — Returns new DateTimeZone object
- timezone_transitions_get — Returns all transitions for the timezone