Partilhar via


fimdesemana()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Fornece o final da semana contendo a data, deslocada por uma compensação, se fornecida.

O último dia da semana é considerado um sábado.

Sintaxe

endofweek( data [, compensação])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
data datetime ✔️ A data usada para encontrar o final da semana.
Deslocamento int O número de semanas de compensação a partir da data. O padrão é 0.

Devoluções

Retorna datetime que representa o final da semana para o valor de data determinado, com o deslocamento, se especificado.

Exemplos

O exemplo a seguir retorna o final da semana para a data especificada.

  range offset from -1 to 1 step 1
 | project weekEnd = endofweek(datetime(2017-01-01 10:10:17), offset)  

Realização

fim de semana
2016-12-31 23:59:59.9999999
2017-01-07 23:59:59.9999999
2017-01-14 23:59:59.9999999

O exemplo a seguir retorna o final da semana como domingo para a data especificada.

let endofweekSunday = (dateArg: datetime) {
    datetime_add('day', 8, endofweek(datetime_add('day', -8, dateArg)))
};
let data=datatable(Date: datetime, day: string)
[
datetime(2025, 6, 14), "Saturday",
datetime(2025, 6, 15), "Sunday",
datetime(2025, 6, 16), "Monday",
datetime(2025, 6, 17), "Tuesday"
];
data 
| extend SundayEndOfWeek=endofweekSunday(Date)

Realização

Data Dia DomingoFimdeSemana
2025-06-14 00:00:00.0000000 Sábado 2025-06-15 23:59:59.9999999
2025-06-15 00:00:00.0000000 Domingo 2025-06-15 23:59:59.9999999
2025-06-16 00:00:00.0000000 Segunda-feira 2025-06-22 23:59:59.9999999
2025-06-17 00:00:00.0000000 Terça-feira 2025-06-22 23:59:59.9999999