(PHP 5, PHP 7)
idate — Formata uma hora/data local como um inteiro
$format
[, int $timestamp = time()
] ) : int
Retorna um número formatado de acordo com um formato informado utilizando o
inteiro timestamp, ou a hora local corrente
se nenhum timestamp foi informado. Em outras palavras, timestamp
é opcional e têm como padrão o valor da função time().
Ao contrário da função date(), a idate(),
aceita apenas um caractere no parâmetro format.
format
Caractere format |
Descrição |
|---|---|
| B | Swatch Beat/Horário da Internet |
| d | Dia do mês |
| h | Hora (no formato de 12 horas) |
| H | Hora (no formato de 24 horas) |
| i | Minutos |
| I (i maiúsculo) | retorna 1 se o horário de verão está ativo, 0, caso contrário |
| L (l maiúsculo) | retorna 1 para anos bissextos, 0, caso contrário |
| m | Número do mês |
| s | Segundos |
| t | Dias do mês atual |
| U | Segundos desde Unix Epoch - January 1 1970 00:00:00 UTC - isso é o mesmo que a função time() |
| w | dia da semana (0 como Domingo) |
| W | Semana do ano, baseado na ISO-8601, com a semana começando na Segunda |
| y | Ano (1 ou 2 dígitos - veja a nota abaixo) |
| Y | Ano (4 dígitos) |
| z | Dia do ano |
| Z | Deslocamento do fuso horário em segundos |
timestamp
O parâmetro opcional timestamp é um
integer Unix timestamp cujo padrão é a hora local
se timestamp não for informado. Em outras
palavras, o padrão é o valor da função time().
Retorna um integer.
Como a função idate() sempre retorna um integer e como ela não começa com um "0", idate() pode retornar menos dígitos que se espera. Veja o exemplo abaixo.
Todas as chamadas a funções de data/hora gerarão um E_NOTICE
se o fuso horário não for válido, e/ou uma mensagem E_STRICT
ou E_WARNING
se utilizar as configurações do sistema ou a variável de ambiente
TZ. Veja também date_default_timezone_set()
| Versão | Descrição |
|---|---|
| 5.1.0 |
Agora lança erros |
Exemplo #1 Exemplo da função idate()
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// this prints the year in a two digit format
// however, as this would start with a "0", it
// only prints "4"
echo idate('y', $timestamp);
?>