Formatar
Retorna data/data hora formatada para idioma português/inglês
- Sintaxe:
Datahora("DATAHORA").Formatar("FORMATO")
- Parâmetros:
- DATAHORA: Data ou Data e Hora (Texto entre aspas duplas) ou variável (sem aspas) ou variável sem aspas
- FORMATO: O padrão é “dd/MM/yyyy HH:mm:ss”. Caso deseje um formato diferente, pode-se montar a partir da tabela abaixo.
- Formatos:
Periodo | Formato | Resultado |
---|---|---|
Ano | y yy yyy yyyy | "8 08 008 2008” |
Mês | M MM MMM MMMM | "3 03 Mar Março" |
Dia | d dd ddd dddd | "9 09 Dom Domingo" |
Hora (12/24) | h hh H HH | "4 04 16 16" |
Minuto | m mmM | "5 05" |
Minuto | s ss | "7 07" |
- Exemplos:
Datahora(“11/03/2019 12:00:00”).Formatar(“dd/MM/yyyy HH:MM:ss”)
- Retorno: 11/03/2019 12:00:00
Datahora(“11/03/2019”).Formatar(“dd MMMM yyyy”)
- Retorno: 11 Março 2019
Obs: Ambos Datahora/Formatar podem receber variáves.
Adicionar/Subtrair
Somar ou subtrair anos, meses, dias, horas, minutos ou segundos de uma data/datahora informada.
- Sintaxe:
Datahora(“DATAHORA”).OPERACAO.PERIODO(VALOR)
- Parâmetros:
- DATAHORA: Data ou Data e Hora (Texto entre aspas duplas) ou variável (sem aspas)
- OPERACAO: Adicionar ou Subtrair
- PERIODO: Ano, Mes, Dia, Hora, Minuto, Segundo
- VALOR: numérico
- Exemplos:
Datahora(“10/03/2019”).Adicionar.Dia(10)
- Retorno: 20/03/2019
Datahora("01/01/2018").Adicionar.Mes(2)
- Retorno: 01/03/2018
Datahora(“01/03/2019 12:50:00”).Subtrair.Minuto(50)
- Retorno: 01/03/2019 12:00:00
Diferença (intervalo entre duas datas)
Retorna a diferença em períodos (Anos, meses, dias, horas, minutos e segundos) entre duas datas.
- Sintaxe:
Datahora(“DATAANTERIOR").DiferencaEmDia("DATAPOSTERIOR")
Datahora(“DATAANTERIOR").DiferencaEmMes("DATAPOSTERIOR")
Datahora(“DATAANTERIOR").DiferencaEmAno("DATAPOSTERIOR")
Datahora(“DATAANTERIOR").DiferencaEmHora("DATAPOSTERIOR")
Datahora(“DATAANTERIOR").DiferencaEmMinuto("DATAPOSTERIOR")
Datahora(“DATAANTERIOR").DiferencaEmSegundo("DATAPOSTERIOR")
- Parâmetros:
- DATAANTERIOR/DATAPOSTERIOR: Data em Texo
- Exemplo:
Datahora(“01/01/2005").DiferencaEmAno("01/01/2010")
- Retorno: 5
Comparador
Compara datas entre duas datas, data maior que e data menor que
- Sintaxe:
DataHora(DATAPARACOMPARAR).DataEntre("DATAINICIAL", "DATAFINAL")
DataHora(DATAPARACOMPARAR).DataMaior("DATAALVO")
DataHora(DATAPARACOMPARAR).DataMenor("DATAALVO")
- Parâmetros:
- DATAPARACOMPARAR: É a data que deverá ser comparada (texto em aspas duplas).
- DATAINICIAL/DATAFINAL/DATAALVO: Texto em aspas duplas.
Serial
Retorna a data em formato serial(numerico milisegundos)
- Sintaxe:
DataHora(DATA).Serial()
- Parâmetros:
- DATA: Data para ser convertida.