datetime_diff()
Calcula o número dos períodos especificados entre dois valores datetime .
Syntax
datetime_diff(
ponto final,
datetime1,
datetime2)
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
ponto final | string |
✔️ | A medição do tempo utilizado para calcular o valor devolvido. Veja os valores possíveis. |
datetime1 | datetime |
✔️ | O lado esquerdo da equação de subtração. |
datetime2 | datetime |
✔️ | O lado direito da equação de subtração. |
Valores possíveis do período
Estes valores não são sensíveis a maiúsculas e minúsculas:
- Anual
- Trimestral
- Mensal
- Semana
- Dia
- Hour
- Minuto
- Second
- Milissegundos
- Microssegundos
- Nanossegundo
Devoluções
Um número inteiro que representa a quantidade de períodos no resultado da subtração (datetime1 - datetime2).
Exemplo
print
year = datetime_diff('year',datetime(2017-01-01),datetime(2000-12-31)),
quarter = datetime_diff('quarter',datetime(2017-07-01),datetime(2017-03-30)),
month = datetime_diff('month',datetime(2017-01-01),datetime(2015-12-30)),
week = datetime_diff('week',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
day = datetime_diff('day',datetime(2017-10-29 00:00),datetime(2017-09-30 23:59)),
hour = datetime_diff('hour',datetime(2017-10-31 01:00),datetime(2017-10-30 23:59)),
minute = datetime_diff('minute',datetime(2017-10-30 23:05:01),datetime(2017-10-30 23:00:59)),
second = datetime_diff('second',datetime(2017-10-30 23:00:10.100),datetime(2017-10-30 23:00:00.900)),
millisecond = datetime_diff('millisecond',datetime(2017-10-30 23:00:00.200100),datetime(2017-10-30 23:00:00.100900)),
microsecond = datetime_diff('microsecond',datetime(2017-10-30 23:00:00.1009001),datetime(2017-10-30 23:00:00.1008009)),
nanosecond = datetime_diff('nanosecond',datetime(2017-10-30 23:00:00.0000000),datetime(2017-10-30 23:00:00.0000007))
Saída
ano | trimestre | month | semana | day | hour | minute | second | milissegundos | microssegundos | nanossegundos |
---|---|---|---|---|---|---|---|---|---|---|
17 | 2 | 13 | 5 | 29 | 2 | 5 | 10 | 100 | 100 | -700 |
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