there is a strftime compatibility package for php>=8.1 at https://github.com/alphp/strftime
(PHP 4, PHP 5, PHP 7, PHP 8)
strftime — Formata uma data/horário de acordo com as configurações locais
Esta função tornou-se DEFASADA a partir do PHP 8.1.0. O uso desta função é fortemente desencorajado.
Alternativas a esta função incluem:
Formata uma data/horário local de acordo com a configuração do idioma. Nome do mês e dia da semana e outras strings respeitam o idioma corrente definido com a função setlocale().
Nem todos os especificadores de conversão podem ser suportados por suas bibliotecas C, e nestes
casos eles não serão suportados pela função do PHP strftime().
Além disso, nem todas as plataformas suportam timestamps negativos, então sua
faixa de datas pode ficar limitada a um valor não anterior à época Unix. Isto significa que
%e, %T, %R e %D (e possivelmente outras) - assim como datas anteriores a
1 de janeiro de 1970 - não funcionarão no Windows, algumas distribuições
Linux, e alguns outros sistemas operacionais. Para sistemas Windows, uma visão
completa dos especificadores de conversão suportados podem ser encontrados em
» MSDN.
No lugar desta função, use
o método IntlDateFormatter::format().
format
format |
Descrição | Exemplo de valores retornados |
|---|---|---|
| Dia | --- | --- |
%a |
Representação textual abreviada do dia | Sun até Sat |
%A |
Representação textual completa do dia | Sunday até Saturday |
%d |
Dia do mês, com dois dígitos (com zeros à esquerda) | 01 a 31 |
%e |
Dia do mês com um dígito, precedido com um espaço. Não implementado como descrito no Windows. Veja abaixo para mais informações. | 1 a 31 |
%j |
Dia do ano, com 3 dígitos e zeros à esquerda | 001 a 366 |
%u |
Representação numérica, do dia da semana, compatível com a ISO-8601 | 1 (para segunda-feira) até 7 (para domingo) |
%w |
Representação numérica do dia da semana | 0 (para domingo) até 6 (para sábado) |
| Semana | --- | --- |
%U |
Número da semana de um dado ano, iniciado com o primeiro domingo sendo a primeira semana | 13 (como a 13ª semana completa do ano) |
%V |
Número da semana, compatível com a ISO-8601:1988 de um dado ano, iniciada com a primeira semana do ano com pelo menos 4 finais de semana, sendo a segunda-feira como o início da semana. | 01 até 53 (onde 53
é responsável por uma sobreposição) |
%W |
Representação numérica da semana do ano, começando pela primeira segunda-feira como primeira semana | 46 (como a 46ª semana do do ano iniciando
na segunda-feira) |
| Mês | --- | --- |
%b |
Nome do mês abreviado, baseado no idioma | jan até dez |
%B |
Nome completo do mês, baseado no idioma | janeiro até dezembro |
%h |
Nome do mês abreviado, baseado no idioma (sinônimo de %b) | jan até dez |
%m |
Representação com dois dígitos do mês | 01 (para janeiro) até 12 (para dezembro) |
| Ano | --- | --- |
%C |
Representação, com dois dígitos, do século (ano dividido por 100, truncado como inteiro) | 19 para o século 20 |
%g |
Representação do ano, com dois dígitos, seguindo o padrão ISO-8601:1988 (veja %V) | Exemplo: 09 de 6 de janeiro de 2009 |
%G |
Versão de 4 dígitos de %g | Exemplo: 2008 de 3 de janeiro de 2009 |
%y |
Representação, com dois dígitos, do ano | Exemplo: 09 de 2009, 79 de 1979 |
%Y |
Representação, com quatro dígitos, do ano | Exemplo: 2038 |
| Hora | --- | --- |
%H |
Representação, com dois dígitos, da hora no formato 24 horas | 00 até 23 |
%k |
Representação da hora no formato 24 horas, com um espaço precedendo dígito único | 0 até 23 |
%I |
Representação, com dois dígitos, da hora no formato 12 horas | 01 até 12 |
%l ('L' minúsculo) |
Representação da hora no formato 12 horas, com um espaço precedendo dígito único | 1 até 12 |
%M |
Representação, com dois dígitos, do minuto | 00 até 59 |
%p |
'AM' ou 'PM' maiúsculo baseado na hora informada | Exemplo: AM para 00:31,
PM para 22:23. O resultado exato depende do
sistema operacional, e pode retornar variantes em minúsculoas, ou
variantes com pontos (como a.m.). |
%P |
'am' ou 'pm' maiúsculo baseado na hora informada | Exemplo: am para 00:31,
pm para 22:23. Não suportado por todos os sistemas
operacionais. |
%r |
O mesmo que "%I:%M:%S %p" | Exemplo: 09:34:17 PM de 21:34:17 |
%R |
O mesmo que "%H:%M" | Exemplo: 00:35 de 12:35 AM, 16:44 de 4:44 PM |
%S |
Representação, com dois dígitos, do segundo | 00 até 59 |
%T |
O mesmo que "%H:%M:%S" | Exemplo: 21:34:17 para 09:34:17 PM |
%X |
Representação escolhida baseada no idioma, sem a data | Exemplo: 03:59:16 ou 15:59:16 |
%z |
O deslocamento do fuso horário. Não implementado como descrito no Windows. Veja mais informações a seguir. | Exemplo: -0500 para hora à leste dos EUA |
%Z |
A abreviação do fuso horário. Não implementado como descrito no Windows. Veja mais informações a seguir. | Exemplo: EST para Eastern Time |
| Carimbos de Data e Hora | --- | --- |
%c |
Carimbo escolhido de data e hora baseado no idioma | Exemplo: Ter Fev 5 00:45:10 2009 de
February 5, 2009 at 12:45:10 AM |
%D |
O mesmo que "%m/%d/%y" | Exemplo: 02/05/09 de February 5, 2009 |
%F |
O mesmo que "%Y-%m-%d" (geralmente utilizado em carimbos de data em bancos de dados) | Exemplo: 2009-02-05 de February 5, 2009 |
%s |
Timestamp Unix(o mesmo que a função time() function) | Exemplo: 305815200 de September 10, 1979 08:40:00 AM |
%x |
Representação da data baseada na preferência da localidade, sem a hora | Exemplo: 02/05/09 de February 5, 2009 |
| Miscelânea | --- | --- |
%n |
Uma nova linha ("\n") | --- |
%t |
Um caractere TAB ("\t") | --- |
%% |
Um caractere literal de porcento ("%") | --- |
Contrário a ISO-9899:1999, o sistema Sun Solaris começa a semana no Domingo, como 1. Resultando
em %u não funcionando como descrito neste
manual.
Somente no Windows:
O modificador %e não possui suporte a implementação
desta função no Windows. Para conseguir este valor, o
modificador %#d pode ser utilizado em substituição. O exemplo a seguir
ilustra como escrever uma função com compatibilidade multiplataforma.
Os modificadores %z e %Z
retornam o nome do fuso horário em vez do deslocamento ou abreviação do mesmo.
macOS and musl only: O modificador %P
não é suportado na implementação macOS desta função.
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 uma string formatada de acordo com o format
informado em timestamp ou o horário local
atual se nenhum timestamp foi informado. Nomes de meses e dia da semana, e outras strings dependentes de linguagens
respeitam o idioma definido
com a função setlocale().
A função retorna false se format for vazio, contém especificadores
de conversão não suportados, ou se o comprimento da string retornada fosse
maior que 4095.
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()
Como a saída depende da biblioteca C disponível, alguns especificadores de
conversão não possuem suporte. No Windows, informar especificadores de
conversão desconhecidos resultará em mensagens E_WARNING e
retornará false. Em outros sistemas operacionais, pode não haver nenhuma
mensagem E_WARNING e a saída poderá conter os
especificadores de conversão não convertidos.
| Versão | Descrição |
|---|---|
| 8.0.0 |
timestamp agora pode ser nulo.
|
Este exemplo funciona se os respectivos idiomas estiverem instalados no sistema.
Exemplo #1 Exemplo da função strftime() com idiomas
<?php
setlocale(LC_TIME, "C");
echo strftime("%A");
setlocale(LC_TIME, "fi_FI");
echo strftime(" em finlandês é %A,");
setlocale(LC_TIME, "fr_FR");
echo strftime(" em francês %A e");
setlocale(LC_TIME, "de_DE");
echo strftime(" em alemão %A.\n");
?>
Exemplo #2 Exemplo do número de semana ISO 8601:1988
<?php
/* Dezembro 2002 / Janeiro 2003
ISOWk M Tu W Thu F Sa Su
----- ----------------------------
51 16 17 18 19 20 21 22
52 23 24 25 26 27 28 29
1 30 31 1 2 3 4 5
2 6 7 8 9 10 11 12
3 13 14 15 16 17 18 19 */
// Mostra: 12/28/2002 - %V,%G,%Y = 52,2002,2002
echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/28/2002")) . "\n";
// Mostra: 12/30/2002 - %V,%G,%Y = 1,2003,2002
echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y", strtotime("12/30/2002")) . "\n";
// Mostra: 1/3/2003 - %V,%G,%Y = 1,2003,2003
echo "1/3/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
// Mostra: 1/10/2003 - %V,%G,%Y = 2,2003,2003
echo "1/10/2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
/* Dezembro 2004 / Janeiro 2005
ISOWk M Tu W Thu F Sa Su
----- ----------------------------
51 13 14 15 16 17 18 19
52 20 21 22 23 24 25 26
53 27 28 29 30 31 1 2
1 3 4 5 6 7 8 9
2 10 11 12 13 14 15 16 */
// Mostra: 12/23/2004 - %V,%G,%Y = 52,2004,2004
echo "12/23/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
// Mostra: 12/31/2004 - %V,%G,%Y = 53,2004,2004
echo "12/31/2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
// Mostra: 1/2/2005 - %V,%G,%Y = 53,2004,2005
echo "1/2/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
// Mostra: 1/3/2005 - %V,%G,%Y = 1,2005,2005
echo "1/3/2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
?>
Exemplo #3 Exemplo do uso do modificador %e compatível com múltiplas plataformas
<?php
// Jan 1: resulta em: '%e%1%' (%%, e, %%, %e, %%)
$format = '%%e%%%e%%';
// Verifica se está no Windows e substitui o modificador %e
// adequadamente
if (strtoupper(substr(PHP_OS, 0, 3)) == 'WIN') {
$format = preg_replace('#(?<!%)((?:%%)*)%e#', '\1%#d', $format);
}
echo strftime($format);
?>
Exemplo #4 Mostra os formatos conhecidos e desconhecidos
<?php
// Descreve os formatos
$strftimeFormats = array(
'A' => 'A full textual representation of the day',
'B' => 'Full month name, based on the locale',
'C' => 'Two digit representation of the century (year divided by 100, truncated to an integer)',
'D' => 'Same as "%m/%d/%y"',
'E' => '',
'F' => 'Same as "%Y-%m-%d"',
'G' => 'The full four-digit version of %g',
'H' => 'Two digit representation of the hour in 24-hour format',
'I' => 'Two digit representation of the hour in 12-hour format',
'J' => '',
'K' => '',
'L' => '',
'M' => 'Two digit representation of the minute',
'N' => '',
'O' => '',
'P' => 'lower-case "am" or "pm" based on the given time',
'Q' => '',
'R' => 'Same as "%H:%M"',
'S' => 'Two digit representation of the second',
'T' => 'Same as "%H:%M:%S"',
'U' => 'Week number of the given year, starting with the first Sunday as the first week',
'V' => 'ISO-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with Monday being the start of the week',
'W' => 'A numeric representation of the week of the year, starting with the first Monday as the first week',
'X' => 'Preferred time representation based on locale, without the date',
'Y' => 'Four digit representation for the year',
'Z' => 'The time zone offset/abbreviation option NOT given by %z (depends on operating system)',
'a' => 'An abbreviated textual representation of the day',
'b' => 'Abbreviated month name, based on the locale',
'c' => 'Preferred date and time stamp based on local',
'd' => 'Two-digit day of the month (with leading zeros)',
'e' => 'Day of the month, with a space preceding single digits',
'f' => '',
'g' => 'Two digit representation of the year going by ISO-8601:1988 standards (see %V)',
'h' => 'Abbreviated month name, based on the locale (an alias of %b)',
'i' => '',
'j' => 'Day of the year, 3 digits with leading zeros',
'k' => 'Hour in 24-hour format, with a space preceding single digits',
'l' => 'Hour in 12-hour format, with a space preceding single digits',
'm' => 'Two digit representation of the month',
'n' => 'A newline character ("\n")',
'o' => '',
'p' => 'UPPER-CASE "AM" or "PM" based on the given time',
'q' => '',
'r' => 'Same as "%I:%M:%S %p"',
's' => 'Unix Epoch Time timestamp',
't' => 'A Tab character ("\t")',
'u' => 'ISO-8601 numeric representation of the day of the week',
'v' => '',
'w' => 'Numeric representation of the day of the week',
'x' => 'Preferred date representation based on locale, without the time',
'y' => 'Two digit representation of the year',
'z' => 'Either the time zone offset from UTC or the abbreviation (depends on operating system)',
'%' => 'A literal percentage character ("%")',
);
// Resultados
$strftimeValues = array();
// Avalia os formatos enqunto suprime os erros.
foreach ($strftimeFormats as $format => $description) {
if (false !== ($value = @strftime("%{$format}"))) {
$strftimeValues[$format] = $value;
}
}
// Encontra o valor mais longo
$maxValueLength = 2 + max(array_map('strlen', $strftimeValues));
// Reporta formatos conhecidos
foreach ($strftimeValues as $format => $value) {
echo "Known format : '{$format}' = ", str_pad("'{$value}'", $maxValueLength), " ( {$strftimeFormats[$format]} )\n";
}
// Reporta formatos desconhecidos
foreach (array_diff_key($strftimeFormats, $strftimeValues) as $format => $description) {
echo "Unknown format : '{$format}' ", str_pad(' ', $maxValueLength), ($description ? " ( {$description} )" : ''), "\n";
}
?>O exemplo acima produzirá algo semelhante a:
Known format : 'A' = 'Friday' ( A full textual representation of the day )
Known format : 'B' = 'December' ( Full month name, based on the locale )
Known format : 'H' = '11' ( Two digit representation of the hour in 24-hour format )
Known format : 'I' = '11' ( Two digit representation of the hour in 12-hour format )
Known format : 'M' = '24' ( Two digit representation of the minute )
Known format : 'S' = '44' ( Two digit representation of the second )
Known format : 'U' = '48' ( Week number of the given year, starting with the first Sunday as the first week )
Known format : 'W' = '48' ( A numeric representation of the week of the year, starting with the first Monday as the first week )
Known format : 'X' = '11:24:44' ( Preferred time representation based on locale, without the date )
Known format : 'Y' = '2010' ( Four digit representation for the year )
Known format : 'Z' = 'GMT Standard Time' ( The time zone offset/abbreviation option NOT given by %z (depends on operating system) )
Known format : 'a' = 'Fri' ( An abbreviated textual representation of the day )
Known format : 'b' = 'Dec' ( Abbreviated month name, based on the locale )
Known format : 'c' = '12/03/10 11:24:44' ( Preferred date and time stamp based on local )
Known format : 'd' = '03' ( Two-digit day of the month (with leading zeros) )
Known format : 'j' = '337' ( Day of the year, 3 digits with leading zeros )
Known format : 'm' = '12' ( Two digit representation of the month )
Known format : 'p' = 'AM' ( UPPER-CASE "AM" or "PM" based on the given time )
Known format : 'w' = '5' ( Numeric representation of the day of the week )
Known format : 'x' = '12/03/10' ( Preferred date representation based on locale, without the time )
Known format : 'y' = '10' ( Two digit representation of the year )
Known format : 'z' = 'GMT Standard Time' ( Either the time zone offset from UTC or the abbreviation (depends on operating system) )
Known format : '%' = '%' ( A literal percentage character ("%") )
Unknown format : 'C' ( Two digit representation of the century (year divided by 100, truncated to an integer) )
Unknown format : 'D' ( Same as "%m/%d/%y" )
Unknown format : 'E'
Unknown format : 'F' ( Same as "%Y-%m-%d" )
Unknown format : 'G' ( The full four-digit version of %g )
Unknown format : 'J'
Unknown format : 'K'
Unknown format : 'L'
Unknown format : 'N'
Unknown format : 'O'
Unknown format : 'P' ( lower-case "am" or "pm" based on the given time )
Unknown format : 'Q'
Unknown format : 'R' ( Same as "%H:%M" )
Unknown format : 'T' ( Same as "%H:%M:%S" )
Unknown format : 'V' ( ISO-8601:1988 week number of the given year, starting with the first week of the year with at least 4 weekdays, with Monday being the start of the week )
Unknown format : 'e' ( Day of the month, with a space preceding single digits )
Unknown format : 'f'
Unknown format : 'g' ( Two digit representation of the year going by ISO-8601:1988 standards (see %V) )
Unknown format : 'h' ( Abbreviated month name, based on the locale (an alias of %b) )
Unknown format : 'i'
Unknown format : 'k' ( Hour in 24-hour format, with a space preceding single digits )
Unknown format : 'l' ( Hour in 12-hour format, with a space preceding single digits )
Unknown format : 'n' ( A newline character ("\n") )
Unknown format : 'o'
Unknown format : 'q'
Unknown format : 'r' ( Same as "%I:%M:%S %p" )
Unknown format : 's' ( Unix Epoch Time timestamp )
Unknown format : 't' ( A Tab character ("\t") )
Unknown format : 'u' ( ISO-8601 numeric representation of the day of the week )
Unknown format : 'v'
Nota: %G e %V, que são baseadas nos números de semana da ISO 8601:1988, podem dar resultados inesperados (embora corretos), se o sistema numérico não for reconhecido perfeitamente. Veja exemplos da %V nesta página do manual.
there is a strftime compatibility package for php>=8.1 at https://github.com/alphp/strftimeYear is being displayed wrongly. It is displaying 2025 instead of 2024
E.g. strftime("%G-%B-%d %H:%M:%S", strtotime(date('2024-12-30 10:10:10')));
Output: 2025-December-30 10:10:10
Here G represents 4-digit year corresponding to the ISO week number. Based on this ISO week number year value will be displayed
Here B represents full month name
Here d represents day of the month (01 to 31)
Now because of this %G value we are getting the issue as ISO week number is calculated wrongly.
For example, If 30th December is falling on Monday, Tuesday, or Wednesday it is in W01 of the next year.
If it is on a Thursday, it is in W53 of the year just ending.
If on a Friday it is in W52 of the year just ending in common years and W53 in leap years.
If on a Saturday or Sunday, it is in W52 of the year just ending.
In this way week calculation happens and as 30th falls on Monday it is taking as W01 of the next year and it displays wrong year output.
For previous year no issue for this error because 30 and 31st Dec falls on sat or Sunday .
This same error occurs even if the Jan 1st falls on Friday. Then it will calculate it as W53 and displays the previous year value instead of current year.