Função dateformat | Início Anterior Próximo

dateformat

A função DateFormat aceita uma série de parâmetros para realizar formatações em valores datas/horas e está registrada internamente pelo WebIntegrator pelo nome df, a sua sintaxe é a seguinte:
|$df(<data>, <tipo-de-formatação>, [<parâmetros-de-formatação>])$|
A depender do tipo de formatação escolhido pelo desenvolvedor a função poderá usar nenhum, um ou vários parâmetros de formatação.
Para especificar uma máscara para um valor DATA/HORA usa-se uma string que especifique este padrão. Neste padrão, todos os caracteres ASCII são reservados como caracteres de padrão, os quais são definidos a seguir:

Símbolo Significado Apresentação Exemplo

| ------- ----------- ------------ -------

| G designador de era (Texto) AD

| y ano (Número) 1996

| M mês do ano (Texto & Número) Julho & 07

| d dia do mês (Número) 10

| h hora em am/pm (1~12) (Número) 12

| H hora do dia (0~23) (Número) 0

| m minutos da hora (Número) 30

| s segundos do minuto (Número) 55

| S millisegundos (Número) 978

| E dia da semana (Texto) Quinta-feira

| D dia do ano (Número) 189

| F dia da semana do mês (Número) 2 (segunda semana)

| w semana do ano (Número) 27

| W semana do mês (Número) 2

| a marcador am/pm (Texto) PM

| k hora do dia (1~24) (Número) 24

| K hora em am/pm (0~11) (Número) 0

| z Time Zone (Texto) Pacific Standard Time

| delimitador de texto (Delimitador)

| aspas simples (Literal)

A quantidade de um determinado caractere de padrão irá determinar qual será o seu formato.
(Texto): quando for especificado 4 ou mais caracteres de padrão de um determinado símbolo será usada a forma extendida, menos de 4 caracteres será usada a forma curta ou abreviada se existir alguma.
(Número): o número mínimo de dígitos. Números menores são preenchidos com zero para essa quantidade. O ano é manipulado especialmente; isto é, se a quantidade de y for 2, o ano será truncado para 2 dígitos.
(Texto & Número): três ou mais, use texto, senão use o formato numérico.
Em seguida, há alguns exemplos mostrando como usar esses padrões e quais os resultados.

Máscara Resultado

| -------------- ---------

| yyyy.MM.dd G às hh:mm:ss z ->> 1996.07.10 AD às 15:08:56 PDT

| EEE, d de MMM d, yy ->> Qua, 10 de Jul, 96

| h:mm a ->> 12:08 PM

| hh horas a, zzzz ->> 12 horas PM, Pacific Daylight Time

| "K:mm a, z" ->> 0:00 PM, PST

| "yyyyy.MMMMM.dd GGG hh:mm aaa" ->> 1996.Julho.10 AD 12:08 PM

Logo abaixo segue uma lista com os tipos de formatações possíveis e seus respectivos parâmetros de formatação.
TIPOS DE FORMATAÇÕES
EXT
Escreve por extenso uma data que esteja no padrão ANSI (yyyy-MM-dd).
Sintaxe:
|$df(<data>, EXT)$|
Exemplos:
|$df(2001-12-20, EXT)$|
FMT
Formata uma data para um outro padrão. O desenvolvedor indica qual o formato em que a data se encontra e qual o novo formato que ela assumirá.
Sintaxe:
|$df(<data>, FMT, <mascaraAtual>, <mascaraNova>)$|
Exemplos:
|$df(2001-12-20, FMT, yyyy-MM-dd, dd/MM/yyyy)$|
INC
Adiciona uma quantidade especificada de dias à data passada no parâmetro. Tanto a data especificada quanto o resultado estará no formato ANSI (yyyy-MM-dd). Caso o desenvolvedor queira adicionar à data algo diferente a dias, ele poderá utilizar um parâmetro adicional informando a que padrão refere-se o número do incremento.
O padrão do incremento é um daqueles símbolos que a função DateFormat suporta, ou seja, M para meses, d para dias, etc. Se esse parâmetro não for passado a função assume que o número do incremento refere-se a dias.
Sintaxe:
|$df(<data>, INC, <número>[, <padrão>])$|
Exemplos:
|$df(2001-12-20, INC, 10)$|
|$df(2001-10-20, INC, 2, M)$|
DEC
Decrementa uma quantidade especificada de dias à data passada no parâmetro. Tanto a data especificada quanto o resultado estarão no formato ANSI (yyyy-MM-dd). Caso o desenvolvedor queira decrementar da data algo diferente a dias, ele poderá utilizar um parâmetro adicional informando a que padrão refere-se o número do decremento.
O padrão do decremento é um daqueles símbolos que a função DateFormat suporta, ou seja, M para meses, d para dias, etc. Se esse parâmetro não for passado a função assume que o número do decremento refere-se a dias.
Sintaxe:
|$df(<data>, DEC, <número>[, <padrão>])$|
Exemplos:
|$df(2001-12-20, DEC, 10)$|
|$df(2001-10-20, DEC, 2, M)$|
SUB
Retorna a diferença em dias entre duas datas. As datas passadas como parâmetro deverão estar no formato ANSI (yyyy-MM-dd).
Sintaxe:
|$df(<data-mais-nova>, SUB, <data-mais-antiga>)$|
Exemplos:
|$df(2001-12-20, SUB, 2000-12-20)$|
WDAY
Retorna o dia da semana. O primeiro dia da semana é o domingo (1) e o último é o sábado(7).
Sintaxe:
|$df(<data>, WDAY, <mascaraAtual>)$|
Exemplos:
|$df(2001-12-20, WDAY, yyyy-MM-dd)$|