dateformat

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)$|