Partilhar via


inicioDaSemana()

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

Devolve o início da semana que contém a data, deslocada por uma compensação, se fornecida.

O início da semana é considerado um domingo.

Sintaxe

startofweek( data [,deslocamento ])

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
data datetime ✔️ A data para a qual encontrar o início da semana.
Deslocamento int O número de semanas a compensar a partir da data de entrada. O padrão é 0.

Devoluções

Um datetime que representa o início da semana para o valor de data determinado, com o deslocamento, se especificado.

Exemplos

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

Realização

semanaInício
2016-12-25 00:00:00.0000000
2017-01-01 00:00:00.0000000
2017-01-08 00:00:00.0000000

O exemplo a seguir retorna o início da semana como segunda-feira para a data especificada.

let startofweekFromMonday = (dateArg: datetime) {
    datetime_add('day', 1, startofweek(datetime_add('day', -1, 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 MondayWeek=startofweekFromMonday(Date)

Realização

Data Dia Segunda-Semana
2025-06-14 00:00:00.0000000 Sábado 2025-06-09 00:00:00.0000000
2025-06-15 00:00:00.0000000 Domingo 2025-06-09 00:00:00.0000000
2025-06-16 00:00:00.0000000 Segunda-feira 2025-06-16 00:00:00.0000000
2025-06-17 00:00:00.0000000 Terça-feira 2025-06-16 00:00:00.0000000