Funzioni WeekNum e ISOWeekNum

Si applica a: App Canvas App basate su modello Power Pages Dataverse Colonne formula

Restituisce il numero della settimana di una data specifica.

Description

Utilizza le funzioni WeekNum eISOWeekNum per determinare il numero della settimana di una data.

Queste funzioni differiscono nel modo in cui determinano la prima settimana dell'anno (settimana 1):

  • WeekNum utilizza la settimana che contiene il 1° gennaio come prima settimana dell'anno. Il risultato di questa funzione può variare da 1 a 54.

  • ISOWeekNum utilizza la settimana contenente il primo giovedì dell'anno come prima settimana dell'anno. Ciò segue la definizione standard di data e ora ISO 8601 per la numerazione delle settimane. Il risultato di questa funzione può variare da 1 a 53. È possibile che 52 o 53 vengano restituiti per i primi giorni di gennaio poiché le date potrebbero appartenere all'ultima settimana dell'anno precedente.

Usa il secondo parametro per WeekNum per specificare il giorno in cui inizia una settimana. Puoi fornire un numero di codice Excel o utilizzare l'enumerazione StartOfWeek:

Codice di Excel Enumerazione StartOfWeek Descrizione
1, 17 InizioSettimana.Domenica La settimana inizia la domenica. Valore predefinito.
2, 11 InizioSettimana.Lunedì La settimana inizia il lunedì.
12 InizioSettimana.Martedì La settimana inizia il martedì.
13 InizioSettimana.Mercoledì La settimana inizia il mercoledì.
14 InizioSettimana.Giovedì La settimana inizia il giovedì.
15 InizioSettimana.Venerdì La settimana inizia il venerdì.
16 InizioSettimana.Sabato La settimana inizia il sabato.

ISOWeekNum utilizza sempre il lunedì come inizio della settimana. In Excel, la funzione WeekNum supporta un codice aggiuntivo 21 non supportato qui; utilizza invece ISOWeekNum.

Se si specifica un numero singolo in queste funzioni, il valore restituito è un valore singolo. Se passi una tabella a colonna singola contenente numeri, il valore restituito è una tabella di risultati a colonna singola, con un risultato per ciascun record nella tabella dell'argomento. Se hai una tabella a più colonne, puoi trasformarla in una tabella a colonna singola, come descritto in Utilizzo delle tabelle.

Sintassi

WeekNum(DataOra [, InizioSettimana ])

  • DateTime - Obbligatorio. Valore data/ora su cui eseguire le operazioni.
  • StartOfWeek - Facoltativo. Codice Excel o enumerazione StartOfWeek che determina il giorno di inizio della settimana.

NumeroSettimanaISO(DataOra)

  • DateTime - Obbligatorio. Valore data/ora su cui eseguire le operazioni. La settimana inizia sempre il lunedì.

Esempi

Prima e ultima settimana di calendario del 2021

Data WeekNum( Date ) ISOWeekNum( Date ) WeekNum( Date, StartOfWeek.Wednesday )
Venerdì1gennaio2021 1 53 1
Sabato2gennaio2021 1 53 1
Sabato3gennaio2021 2 53 1
Lunedì4gennaio2021 2 1 1
Martedì5gennaio2021 2 1 1
Mercoledì6gennaio2021 2 1 2
Giovedì7gennaio2021 2 1 2
Sabato25Dicembre2021 52 51 52
Domenica26Dicembre2021 53 51 52
Lunedì27Dicembre2021 53 52 52
Martedì28Dicembre2021 53 52 52
Mercoledì29Dicembre2021 53 52 53
Giovedì30Dicembre2021 53 52 53
Venerdì31Dicembre2021 53 52 53