Bloco de Função DT2STR
O bloco de função DT2STR converte uma hora com o formato especificado em uma string.
Entrada DT
A entrada define a data em DT#, que é usada para calcular. Se nenhuma data for especificada, será calculado com o carimbo de tempo 0.
Entrada FORMAT
A entrada define o formato como uma string. Se nenhum valor for definido ou deixado em branco, a string "Y-m-d H:i:s" será assumida.
Dica: Para exibir uma letra ou d, cada letra deve ser marcada com os caracteres de escape \. Exemplo: "\d\a\y: d" exibe "day: 01".
| Caracteres de Formato | Descrição | Exemplo de Valores de Retorno |
|---|---|---|
| Dia | ||
| d | Dia do mês, 2 dígitos com zero à esquerda | 01 até 31 |
| D | Dia da semana, abreviado para três letras | Mon até Sun |
| j | Dia do mês sem zeros à esquerda | 1 até 31 |
| l (pequeno 'L') | Dia da semana por extenso | Sunday até Saturday |
| N | Representação numérica do dia da semana de acordo com a ISO-8601 | 1 (para segunda-feira) até 7 (para domingo) |
| S | Anexo da enumeração em inglês para um dia do mês, dois caracteres | st, nd, rd ou th. Recomendado para uso com j. |
| w | Dia numérico de uma semana | 0 (para domingo) até 6 (para sábado) |
| z | O dia do ano (começando em 0) | 0 até 365 |
| Semana | ||
| W | Número da semana do ano ISO-8601, a semana começa na segunda-feira | Exemplo: 42 (a 42ª semana do ano) |
| Mês | ||
| F | Mês como palavra inteira, como January ou March | January até December |
| m | Mês como número, com zeros à esquerda | 01 até 12 |
| M | Nome do mês com três letras | Jan até Dec |
| n | Número do mês, sem zeros à esquerda | 1 até 12 |
| t | Número de dias do mês especificado | 28 até 31 |
| Ano | ||
| L | Ano bissexto ou não | 1 para um ano bissexto, caso contrário 0 |
| o | Número do ano da semana do calendário de acordo com a ISO-8601. Isso resulta no mesmo valor que Y, exceto quando a semana do calendário ISO (W) pertence ao ano anterior ou seguinte, usando então aquele ano. | Exemplos: 1999 ou 2003 |
| Y | Ano com quatro dígitos | Exemplos: 1999 ou 2003 |
| y | Ano com dois dígitos | Exemplos: 99 ou 03 |
| Hora | ||
| a | Minúsculo: Ante meridiem (manhã) e Post meridiem (tarde) | am ou pm |
| A | Maiúsculo: Ante meridiem (manhã) e Post meridiem (tarde) | AM ou PM |
| B | Swatch Internet Time | 000 até 999 |
| g | Hora no formato de 12 horas, sem zeros à esquerda | 1 até 12 |
| G | Hora no formato de 24 horas, sem zeros à esquerda | 0 até 23 |
| h | Hora no formato de 12 horas, com zeros à esquerda | 01 até 12 |
| H | Hora no formato de 24 horas, com zeros à esquerda | 00 até 23 |
| i | Minutos, com zeros à esquerda | 00 até 59 |
| s | Segundos, com zeros à esquerda | 00 até 59 |
| u | Microsegundos. Sempre produz a saída 000000. | Exemplo: 000000 |
| Fuso Horário | ||
| e | Identificador de fuso horário | Exemplos: UTC, GMT, Atlantic/Azores |
| I (grande 'i') | Se uma data cai no horário de verão | 1 para horário de verão, caso contrário 0. |
| O | Diferença de tempo em relação ao horário de Greenwich (GMT) em horas | Exemplo: +0200 |
| P | Diferença de tempo em relação ao horário de Greenwich (GMT) em horas com dois pontos entre horas e minutos | Exemplo: +02:00 |
| T | Abreviação do fuso horário | Exemplos: EST, MDT... |
| Z | Deslocamento do fuso horário em segundos. O deslocamento para fusos horários a oeste de UTC é sempre negativo e para fusos horários a leste de UTC é sempre positivo. | -43200 até 50400 |
| z | Retorna o dia do ano sem zero à esquerda | |
| Data/Hora Completa(s) | ||
| c | Data ISO 8601 | 2004-02-12T15:19:21+00:00 |
| r | Data formatada de acordo com o formato » RFC 2822 | Exemplo: Thu, 21 Dec 2000 16:01:07 +0200 |
| U | Segundos desde o início da era UNIX (January 1 1970 00:00:00 GMT) | Veja também o bloco de função TIME |
Saída STR
A saída retorna uma string com o formato especificado.