Funções de data e hora

Funções de data e hora retornam os dados de data e hora. Note que você talvez precise converter o formato de seus dados de origem no aplicativo.

Tabela 1: Funções de data e hora

Função

Sintaxe

Descrição

AddMonthToDate(#date#,periods)

  • #date#: data original
  • periods: Número de períodos a serem adicionados

Retorna uma data que é gerada pela adição de um número específico de meses a determinada data.

Por exemplo:
AddMonthToDate(#2012-01-01#,1)
retorna 2012-02-01

AddMonthToDate(#date#,periods)

  • #date#: data original
  • periods: Número de períodos a serem adicionados

Retorna uma data que é gerada pela adição de um número específico de semanas a determinada data.

Por exemplo:
AddWeekToDate(#2012-01-01#,1)
retorna 08.01.12

AddYearToDate(#date#,periods)

  • #date#: data original
  • periods: Número de períodos a serem adicionados

Retorna uma data que é gerada pela adição de um número específico de anos a determinada data. Utilize números negativos para remover um ano.

Por exemplo:
AddYearToDate(#2012-01-01#,1)
retorna 01.01.13

CurrentDate()

Retorna a data atual como uma data.

Por exemplo:
CurrentDate()
retorna <CurrentDate>

DateDiffInDays(#start#,#end#)

  • #start#: Data de início do intervalo
  • #end#: Data de término do intervalo

Retorna o número de dias entre duas datas.

Por exemplo:
DateDiffInDays(#2012-03-23#,#2012-01-30#)
retorna -53

DateDiffInMonths(#start#,#end#)

  • #start#: Data de início do intervalo
  • #end#: Data de término do intervalo

Retorna o número de meses entre duas datas especificadas.

Por exemplo:
DateDiffInMonths(#2013-02-01#,#2014-01-01#)
retorna 11

Day(#date#)

#date#: uma data

Retorna o dia do mês como um número de 1 a 31.

Por exemplo:
Day(#2012-03-23#)
retorna 23

DayOfWeek(#date#)

#date#: uma data

Retorna o dia da semana como um número de 1 (domingo) à 7 (sábado).

Por exemplo:
DayOfWeek(#2012-03-23#)
retorna 6

DayOfYear(#date#)

#date#: uma data

Retorna o dia do ano como um número.

Por exemplo:
DayOfYear(#2012-03-23#)
retorna 83

LastDayOfMonth(#date#)

#date#: uma data

Retorna a data gerada pelo cálculo do último dia do mês de determinada data.

Por exemplo:
LastDayOfMonth(#2012-03-23#)
retorna a data 2012-03-31

LastDayOfWeek(#date#)

#date#: uma data

Retorna a data gerada pelo cálculo do último dia da semana de determinada data.

Por exemplo:
LastDayOfWeek(#2012-03-23#)
retorna a data 24.03.12

MakeDate(year,month,day)

  • year: Número que representa um ano
  • month: Número que representa um mês
  • day: Número que representa um dia do mês

Retorna uma data gerada com base no ano, mês e dia especificados.

Por exemplo:
MakeDate(2011,6,12)
retorna a data 12.06.11

Month(#date#)

#date#: uma data

Retorna o mês do ano como um número de 1 a 12.

Por exemplo:
Month(#2012-03-23#)
retorna 3

Quarter(#date#)

#date#: uma data

Retorna um número que representa o trimestre de determinada data.

Por exemplo:
Quarter(#2012-03-23#)
retorna 1

Week(#date#)

#date#: uma data

Retorna um número que representa a semana de determinada data.

Por exemplo:
Week(#2012-03-23#)
retorna 12

Year(#date#)

#date#: uma data

Retorna o ano de determinada data.

Por exemplo:
Year(#2012-03-23#)
retorna 2012