Partilhar via

Lista de operações de data e hora

  • Artigo

TODATE([year],[month],[day])

Cria uma data a partir das partes de data especificadas.

Parâmetros:- [year] - a parte do ano da data. Tipo de dados: INT

  • [month] - a parte do mês da data. Tipo de dados: INT

  • [day] - a parte do dia da data

    Tipo de dados: INT

Tipo de dados de saída: DATE

TODATE([year],[month],[day],[hour],[minute],[second],[millisecond])

Cria uma data a partir das partes de data especificadas juntamente com a hora.

Parâmetros:- [year] - a parte do ano da data

Tipo de dados: INT

  • [month] - a parte do mês da data

    Tipo de dados: INT

  • [day] - a parte do dia da data

    Tipo de dados: INT

  • [hour] - a parte da hora da data

    Tipo de dados: INT

  • [minute] - a parte do minuto da data

    Tipo de dados: INT

  • [second] - a parte do segundo da data

    Tipo de dados: INT

  • [millisecond] - a parte do milissegundo da data

    Tipo de dados: INT

Tipo de dados de saída: DATE

TODATE([year],[month],[day],[time])

Cria uma data a partir das partes de data especificadas juntamente com a hora.

Parâmetros:- [year] - a parte do ano da data

Tipo de dados: INT

  • [month] - a parte do mês da data

    Tipo de dados: INT

  • [day] - a parte do dia da data

    Tipo de dados: INT

  • [time] - a parte da hora da data

    Tipo de dados: INT

Tipo de dados de saída: DATE

TOTIME([hour],[minute],[second],[millisecond])

Cria um intervalo de tempo a partir das partes de data especificadas.

Parâmetros:- [hour] - a parte da hora da data

Tipo de dados: INT

  • [minute] - a parte do minuto da data

    Tipo de dados: INT

  • [second] - a parte do segundo da data

    Tipo de dados: INT

  • [millisecond] - a parte do milissegundo da data

    Tipo de dados: INT

Tipo de dados de saída: TIME

TOTIMEFROMDAYS([value])

Cria um intervalo de tempo a partir do número total de dias.

Parâmetros:- [value] - nome do atributo, operação aninhada ou expressão para criar um intervalo de tempo

Tipo de dados: INT

Tipo de Dados de Saída: TIME, FLOAT

TOTIMEFROMHOURS([value])

Cria um intervalo de tempo a partir do número total de horas.

Parâmetros:- [value] - nome do atributo, operação aninhada ou expressão para criar um intervalo de tempo

Tipo de dados: INT

Tipo de Dados de Saída: TIME, FLOAT

TOTIMEFROMMILLIS([value])

Cria um intervalo de tempo a partir do número total de milissegundos.

Parâmetros:- [value] - nome do atributo, operação aninhada ou expressão para criar um intervalo de tempo

Tipo de dados: INT

Tipo de dados de saída: TIME

TOTIMEFROMMINUTES([value])

Cria um intervalo de tempo a partir do número total de minutos.

Parâmetros:- [value] - nome do atributo, operação aninhada ou expressão para criar um intervalo de tempo

Tipo de dados: INT, FLOAT

Tipo de dados de saída: TIME

TOTIMEFROMSECONDS([value])

Cria um intervalo de tempo a partir do número total de segundos.

Parâmetros:- [value] - nome do atributo, operação aninhada ou expressão para criar um intervalo de tempo

Tipo de dados: INT, FLOAT

Tipo de dados de saída: TIME

ADDDAYS([date],[count])

Adiciona o número especificado de dias ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os dias de trabalho são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de dias de trabalho que são adicionados à data

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDHOURS([date],[count])

Adiciona o número especificado de horas ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual as horas de trabalho são adicionadas

Tipo de dados: DATE, TIME

  • [count] - o número de horas que são adicionadas à data

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDMILLIS([date],[count])

Adiciona o número especificado de milissegundos ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os milissegundos são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de milissegundos que são adicionadas à data

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDMINUTES([date],[count])

Adiciona o número especificado de minutos ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os minutos são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de minutos que são adicionados à data

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDMONTHS([date],[count])

Adiciona o número especificado de meses ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os meses são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de meses que são adicionados à data, ignora valores fracionários

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDSECONDS([date],[count])

Adiciona o número especificado de segundos ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os segundos são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de segundos que são adicionados à data

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

ADDYEARS([date],[count])

Adiciona o número especificado de anos ao intervalo de data/hora.

Parâmetros:- [date] - uma data específica à qual os anos são adicionados

Tipo de dados: DATE, TIME

  • [count] - o número de anos que são adicionados à data, ignora valores fracionários

    Tipo de dados: INT, FLOAT

Tipo de Dados de Saída: DATE, TIME

DATE([date])

Devolve a parte da data sem um intervalo de tempo.

Parâmetros:- [date] - a data a partir da qual a parte da data é devolvida

Tipo de dados: DATE

Tipo de dados de saída: DATE

DAY([date])

Devolve o dia do mês a partir da data.

Parâmetros:- [date] - a data a partir da qual a parte do dia é devolvida

Tipo de dados: DATE

Tipo de dados de saída: INT

DAYOFWEEK([date])

Devolve o dia da semana a partir da data.

Parâmetros:- [date] - a data a partir da qual o dia da semana é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

DAYOFYEAR([date])

Devolve o dia do ano a partir da data.

Parâmetros:- [date] - a data a partir da qual o dia do ano é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

HOUR([date])

Devolve uma hora a partir da data.

Parâmetros:- [date] - a data a partir da qual a hora é devolvida

Tipo de dados: DATE

Tipo de dados de saída: INT

MILLISECOND([date])

Devolve um milissegundo a partir da data.

Parâmetros:- [date] - a data a partir da qual o milissegundo é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

MINUTE([date])

Devolve um minuto a partir da data.

Parâmetros:- [date] - a data a partir da qual o minuto é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

MONTH([date])

Devolve um mês a partir da data.

Parâmetros:- [date] - a data a partir da qual o mês é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

QUARTER([date])

Devolve o trimestre a partir da data.

Parâmetros:- [date] - a data a partir da qual o trimestre é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

SECOND([date])

Devolve a parte dos segundos a partir da data.

Parâmetros:- [date] - a data a partir da qual o segundo é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

TIMEOFDAY([date])

Devolve a parte da hora da data.

Parâmetros:- [date] - a data a partir da qual a parte da hora é devolvida

Tipo de dados: DATE

Tipo de dados de saída: TIME

WEEKOFYEAR([date])

Devolve o número da semana do ano a partir de uma data de acordo com a norma ISO 8601.

Parâmetros:- [date] - a data a partir da qual o número da semana do ano de acordo com a norma ISO 8601 é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

YEAR([date])

Devolve o ano a partir da data.

Parâmetros:- [date] - a data a partir da qual o ano é devolvido

Tipo de dados: DATE

Tipo de dados de saída: INT

ISLEAPYEAR([ano])

Devolve TRUE se o ano for bissexto; caso contrário, devolve FALSE.

Parâmetros:- [year] - o ano que estou a verificar se é ou não um ano bissexto

Tipo de dados: INT

Tipo de dados de saída: BOOL

DAYS([time])

Devolve a parte do dia a partir do intervalo de tempo.

Parâmetros:- [time] - a data a partir da qual a parte do dia é devolvida

Tipo de dados: TIME

Tipo de dados de saída: INT

HOURS([time])

Devolve a parte da hora a partir do intervalo de tempo.

Parâmetros:- [time] - a data a partir da qual a parte da hora é devolvida

Tipo de dados: TIME

Tipo de dados de saída: INT

MILLISECONDS([time])

Devolve a parte de milissegundo a partir do intervalo de tempo.

Parâmetros:- [time] - a data a partir da qual a parte do milissegundo é devolvida

Tipo de dados: TIME

Tipo de dados de saída: INT

MINUTES([time])

Devolve a parte do minuto a partir do intervalo de tempo.

Parâmetros:- [time] - a data a partir da qual a parte do minuto é devolvida

Tipo de dados: TIME

Tipo de dados de saída: INT

SECONDS([time])

Devolve a parte do segundo a partir do intervalo de tempo.

Parâmetros:- [time] - a data a partir da qual a parte do segundo é devolvida

Tipo de dados: TIME

Tipo de dados de saída: INT

TOTALDAYS([time])

Devolve o valor do intervalo de tempo expresso em dias inteiros e fracionados.

Parâmetros:- [time] - a data a partir da qual o intervalo de tempo expresso em dias inteiros e fracionados é devolvido

Tipo de dados: TIME

Tipo de Dados de Saída: FLOAT

TOTALHOURS([time])

Devolve o valor do intervalo de tempo expresso em horas inteiras e fracionadas.

Parâmetros:- [time] - a data a partir da qual o intervalo de tempo expresso em horas inteiras e fracionadas é devolvido

Tipo de dados: TIME

Tipo de Dados de Saída: FLOAT

TOTALMILLIS([time])

Devolve o valor do intervalo de tempo expresso em milissegundos inteiros e fracionados.

Parâmetros:- [time] - a data a partir da qual o intervalo de tempo expresso em milissegundos inteiros e fracionados é devolvido

Tipo de dados: TIME

Tipo de Dados de Saída: FLOAT

TOTALMINUTES([time])

Devolve o valor do intervalo de tempo expresso em minutos inteiros e fracionados.

Parâmetros:- [time] - a data a partir da qual o intervalo de tempo expresso em minutos inteiros e fracionados é devolvido

Tipo de dados: TIME

Tipo de Dados de Saída: FLOAT

TOTALSECONDS([time])

Devolve o valor do intervalo de tempo expresso em segundos inteiros e fracionados.

Parâmetros:- [time] - a data a partir da qual o intervalo de tempo expresso em segundos inteiros e fracionados é devolvido

Tipo de dados: TIME

Tipo de Dados de Saída: FLOAT

ISWORKINGHOUR([dateTime])

Devolve true quando a data e hora pertence às horas de trabalho definidas no calendário real.

Parâmetros:- [dateTime] - a data a avaliar

Tipo de dados: DATE

Tipo de dados de saída: BOOL

ISWORKINGDAY([date])

Devolve true quando a data pertence ao dia de trabalho definido no calendário real.

Parâmetros:- [date] - a data a avaliar

Tipo de dados: DATE

Tipo de Dados de Saída: FLOAT

ISPUBLICHOLIDAY([date])

Devolve true quando a data pertence ao feriado público definido no calendário real.

Parâmetros:- [date] - a data a avaliar

Tipo de dados: DATE

Tipo de Dados de Saída: FLOAT

DURATIONCALENDAR([startDate], [endDate])

Devolve a duração do tempo de trabalho entre duas datas do calendário real calculadas.

Importante

Os cálculos associados ao calendário de trabalho só funcionam corretamente no intervalo desde o início do processo menos 6 meses até ao fim do processo mais 24 meses. Calcular os valores do calendário como dias de trabalho ou horas de trabalho fora deste intervalo devolverá um erro e um valor predefinido. Este intervalo de calendário não pode ser definido por si na aplicação e é aplicado automaticamente após cada atualização de dados. Parâmetros: - [startDate] — data de início do intervalo de tempo.

Tipo de dados: DATE

  • [endDate] - data de fim do intervalo de tempo

    Tipo de dados: DATE

Tipo de Dados de Saída: FLOAT

ADDWORKINGDAYS([date],[count])

Adiciona o número especificado de dias de trabalho à data. O número exato de horas de trabalho definidas não é relevante. Qualquer dia que seja marcado como dia de trabalho é contabilizado como um.

Importante

Os cálculos associados ao calendário de trabalho devolvem resultados corretos apenas no intervalo de 6 meses antes do início do processo, até 24 meses depois da data de fim do processo. Calcular os valores do calendário (por exemplo, dias de trabalho e horas de trabalho) fora deste intervalo devolverá um erro e um valor predefinido. Este intervalo é aplicado automaticamente depois de cada atualização de dados e não está disponível para alteração. Parâmetros: - [date] - uma data específica à qual os dias de trabalho são adicionados.

Tipo de dados: DATE

  • [count] - o número de dias de trabalho que são adicionados à data

    Tipo de dados: INT

Tipo de dados de saída: DATE

ADDWORKINGHOURS([date],[count])

Adiciona o número especificado de horas de trabalho à data.

Importante

Os cálculos associados ao calendário de trabalho devolvem resultados corretos apenas no intervalo de 6 meses antes do início do processo, até 24 meses depois da data de fim do processo. Calcular os valores do calendário (por exemplo, dias de trabalho e horas de trabalho) fora deste intervalo devolverá um erro e um valor predefinido. Este intervalo é aplicado automaticamente depois de cada atualização de dados e não está disponível para alteração. Parâmetros: - [date] - uma data específica à qual as horas de trabalho são adicionadas.

Tipo de dados: DATE

  • [count] - o número de horas de trabalho que são adicionadas à data

    Tipo de dados: INT

Tipo de dados de saída: DATE

ADDWORKINGMINUTES([date],[count])

Adiciona o número especificado de minutos de trabalho à data.

Importante

Os cálculos associados ao calendário de trabalho devolvem resultados corretos apenas no intervalo de 6 meses antes do início do processo, até 24 meses depois da data de fim do processo. Calcular os valores do calendário (por exemplo, dias de trabalho e horas de trabalho) fora deste intervalo devolverá um erro e um valor predefinido. Este intervalo é aplicado automaticamente depois de cada atualização de dados e não está disponível para alteração. Parâmetros: - [date] - uma data específica à qual os minutos de trabalho são adicionados.

Tipo de dados: DATE

  • [count] - o número de minutos de trabalho que são adicionados à data

    Tipo de dados: INT

Tipo de dados de saída: DATE