datetime_add()
Calcula um novo datetime de um período especificado multiplicado por uma quantidade especificada, adicionada ou subtraída de um datetime especificado.
Syntax
datetime_add(
ponto final,
montante,
datetime)
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
ponto final | string |
✔️ | O período de tempo pelo qual incrementar. |
montante | int |
✔️ | O número de períodos a adicionar ou subtrair do datetime. |
datetime | datetime |
✔️ | A data a incrementar pelo resultado do cálculo da quantidade x do período. |
Valores possíveis do período:
- Anual
- Trimestral
- Mensal
- Semana
- Dia
- Hour
- Minuto
- Second
- Milissegundos
- Microssegundo
- Nanossegundo
Devoluções
Um datetime após a adição de um determinado intervalo de hora/data.
Exemplos
Período
print year = datetime_add('year',1,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',1,make_datetime(2017,1,1)),
month = datetime_add('month',1,make_datetime(2017,1,1)),
week = datetime_add('week',1,make_datetime(2017,1,1)),
day = datetime_add('day',1,make_datetime(2017,1,1)),
hour = datetime_add('hour',1,make_datetime(2017,1,1)),
minute = datetime_add('minute',1,make_datetime(2017,1,1)),
second = datetime_add('second',1,make_datetime(2017,1,1))
Saída
ano | trimestre | month | semana | day | hour | minute | second |
---|---|---|---|---|---|---|---|
2018-01-01 00:00:00.0000000 | 2017-04-01 00:00:00.0000000 | 2017-02-01 00:00:00.0000000 | 2017-01-08 00:00:00.0000000 | 2017-01-02 00:00:00.0000000 | 2017-01-01 01:00:00.0000000 | 2017-01-01 00:01:00.0000000 | 2017-01-01 00:00:01.0000000 |
Montante
print year = datetime_add('year',-5,make_datetime(2017,1,1)),
quarter = datetime_add('quarter',12,make_datetime(2017,1,1)),
month = datetime_add('month',-15,make_datetime(2017,1,1)),
week = datetime_add('week',100,make_datetime(2017,1,1))
Saída
ano | trimestre | month | semana |
---|---|---|---|
01-01-01T00:00:00Z | 2020-01-01T00:00:00Z | 2015-10-01T00:00:00Z | 2018-12-02T00:00:00Z |
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários