(PHP 5, PHP 7, PHP 8)
idate — Formata uma parte de uma hora/data local como um inteiro
Retorna um número formatado de acordo com um formato informado utilizando o inteiro timestamp, ou o horário local atual se nenhum timestamp foi informado. Em outras palavras, timestamp é opcional e tem 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.
formatCaractere 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 |
N | Dia da semana, baseado na ISO-8601 (1 para segunda-feira até7 para domingo) |
o | ISO-8601 year (4 digits) |
s | Segundos |
t | Dias do mês atual |
U | Segundos desde a época Unix - January 1 1970 00:00:00 UTC - isso é o mesmo que a função time() |
w | Dia da semana (0 para domingo) |
W | Semana do ano, baseado na ISO-8601, com a semana começando na segunda-feira |
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 int de timestamp Unix cujo padrão é a hora local atual se timestamp não for informado ou for null. Em outras palavras, o padrão é o valor de time().
Retorna um int em caso de sucesso, ou false em caso de falha.
Como a função idate() sempre retorna um int e como ela não começa com um "0", idate() pode retornar menos dígitos do que se espera. Veja o exemplo abaixo.
Toda chamada a uma função de data/hora gerará um E_WARNING se o fuso horário não for válido. Veja também date_default_timezone_set()
| Versão | Descrição |
|---|---|
| 8.2.0 | Inclui os caracteres de formato N (dia da semana ISO-8601) e o (ano ISO-8601). |
| 8.0.0 | timestamp agora pode ser nulo. |
Exemplo #1 Exemplo da função idate()
<?php
$timestamp = strtotime('1st January 2004'); //1072915200
// este código imprime o ano em um formato de dois dígitos
// entretanto, como começaria com um "0", ele
// só imprime "4"
echo idate('y', $timestamp);
?>