Compartir a través de

Funciones WeekNum e ISOWeekNum

  • Artículo

Se aplica a: Aplicaciones de lienzo Aplicaciones basadas en modelos Power Pages Columnas de fórmulas de Dataverse

Devuelve el número de semana de una fecha determinada.

Description

Utilice lsa funciones WeekNum e ISOWeekNum para determinar el número de semana de una fecha.

Estas funciones difieren en cómo determinan la primera semana del año (semana 1):

  • WeekNum usa la semana que contiene el 1 de enero como la primera semana del año. El resultado de esta función puede oscilar entre 1 y 54.

  • ISOWeekNum utiliza la semana que contiene el primer jueves del año como la primera semana del año. Sigue la definición de fecha y hora de la norma ISO 8601 para la numeración de la semana. El resultado de esta función puede oscilar entre 1 y 53. Es posible que se devuelvan 52 o 53 para los primeros días de enero ya que las fechas podrían pertenecer a la última semana del año anterior.

Utilice el segundo parámetro para WeekNum para especificar qué día comienza una semana. Puede proporcionar un número de código de Excel o utilizar la enumeración StartOfWeek:

Código de Excel Enumeración de StartOfWeek Descripción
1, 17 StartOfWeek.Sunday La semana comienza el domingo. Predeterminado.
2, 11 StartOfWeek.Monday La semana comienza el lunes.
12 StartOfWeek.Tuesday La semana comienza el martes.
13 StartOfWeek.Wednesday La semana comienza el miércoles.
14 StartOfWeek.Thursday La semana comienza el jueves.
15 StartOfWeek.Friday La semana comienza el viernes.
16 StartOfWeek.Saturday La semana comienza el sábado.

ISOWeekNum siempre utiliza el lunes como inicio de semana. En Excel, la función WeekNum admite un código de adición 21 que no se admite aquí; use ISOWeekNum en su lugar.

Si pasa un solo número a estas funciones, el valor que se devuelve es un resultado único. Si pasa una tabla de una sola columna que contiene números, el valor que se muestra es una tabla de resultados de una sola columna, un resultado para cada registro en la tabla del argumento. Si tiene una tabla con varias columnas, puede convertirla en una tabla de una sola columna, como se describe en cómo trabajar con tablas.

Sintaxis

WeekNum(DateTime [, StartOfWeek ])

  • DateTime: requerido. Valor de fecha y hora con el que operar.
  • StartOfWeek: opcional. Código de Excel o enumeración StartOfWeek que determina qué día comienza la semana.

ISOWeekNum(DateTime)

  • DateTime: requerido. Valor de fecha y hora con el que operar. La semana siempre empieza el lunes.

Ejemplos

Primera y última semana natural de 2021

Fecha WeekNum( Date ) ISOWeekNum( Date ) WeekNum( Date, StartOfWeek.Wednesday )
Viernes,1de enero de2021 1 53 1
Sábado,2de enero de2021 1 53 1
Domingo,3de enero de2021 2 53 1
Lunes,4de enero de2021 2 1 1
Martes,5de enero de2021 2 1 1
Miércoles,6de enero de2021 2 1 2
Jueves,7de enero de2021 2 1 2
Sábado,25de diciembre de2021 52 51 52
Domingo,26de diciembre de2021 53 51 52
Lunes,27de diciembre de2021 53 52 52
Martes,28de diciembre de2021 53 52 52
Miércoles,29de diciembre de2021 53 52 53
Jueves,30de diciembre de2021 53 52 53
Viernes,31de diciembre de2021 53 52 53