الدالتان WeekNum وISOWeekNum

تنطبق على: تطبيقات اللوحة التطبيقات التي تستند إلى النماذج Power Pages أعمدة الصيغ Dataverse

إرجاع رقم الأسبوع لتاريخ محدد.

الوصف

استخدم وظائف WeekNum و ISOWeekNum لتحديد رقم الأسبوع لتاريخ.

تختلف هذه الوظائف في كيفية تحديدها الأسبوع الأول من العام (الأسبوع 1):

  • WeekNum يستخدم الأسبوع الذي يحتوي على 1 يناير كالأسبوع الأول من العام. يمكن أن تتراوح النتيجة من هذه الوظيفة من 1 إلى 54.

  • ISOWeekNum يستخدم الأسبوع الذي يحتوي على الخميس الأول من العام على أنه الأسبوع الأول من العام. وهذا يتبع التعريف القياسي للوقت والتاريخ ISO 8601 لترقيم الأسبوع. يمكن أن تتراوح النتيجة من هذه الوظيفة من 1 إلى 53. من الممكن إرجاع 52 أو 53 للأيام الأولى من شهر يناير نظرًا لأن التواريخ قد تنتمي إلى الأسبوع الأخير من العام السابق.

استخدم المعلمة الثانية إلى WeekNum لتحديد اليوم الذي يبدأ فيه الأسبوع. يمكنك توفير رقم رمز Excel أو استخدام تعداد StartOfWeek:

رمز Excel تعداد StartOfWeek الوصف
1, 17 StartOfWeek.Sunday يبدأ الأسبوع من يوم الأحد. الإعداد الافتراضي.
2, 11 StartOfWeek.Monday يبدأ الأسبوع من يوم الإثنين.
12 StartOfWeek.Tuesday يبدأ الأسبوع من يوم الثلاثاء.
13 StartOfWeek.Wednesday يبدأ الأسبوع من يوم الأربعاء.
14 StartOfWeek.Thursday يبدأ الأسبوع من يوم الخميس.
15 StartOfWeek.Friday يبدأ الأسبوع من يوم الجمعة.
16 StartOfWeek.Saturday يبدأ الأسبوع من يوم السبت.

ISOWeekNum يستخدم دائمًا الإثنين كبداية للأسبوع. في Excel، تدعم الوظيفة WeekNum رمزًا إضافيًا 21 غير مدعوم هنا؛ استخدم ISOWeekNum بدلاً من ذلك.

إذا قمت بتمرير رقم واحد لهذه الوظائف ، فإن القيمة المرجعة هي نتيجة واحدة. إذا قمت بتمرير جدول من عمود واحد الذي يحتوي على أرقام ، والقيمة المرجعة هي جدول نتائج أحادي العمود للنتائج ، نتيجة واحدة لكل سجل في جدول الوسيطة. إذا كان لديك جدول متعدد الأعمدة، يمكنك تشكيله في جدول من عمود واحد، مثلما يصف التعامل مع الجداول.

بناء الجملة

WeekNum(DateTimeStartOfWeek ])

  • DateTime - مطلوب. قيمة التاريخ/الوقت المطلوب العمل بها.
  • StartOfWeek - اختياري. رمز Excel أو تعداد StartOfWeek الذي يحدد اليوم الذي يبدأ فيه الأسبوع.

ISOWeekNum(DateTime)

  • DateTime - مطلوب. قيمة التاريخ/الوقت المطلوب العمل بها. الأسبوع يبدأ دائمًا في يوم الإثنين.

الأمثلة

الأسابيع الأولى والأخيرة من التقويم لعام 2021

التاريخ‬ WeekNum( Date ) ISOWeekNum( Date ) WeekNum( Date, StartOfWeek.Wednesday )
الجمعة،يناير1،2021 1 53 1
السبت،يناير2،2021 1 53 1
الأحد،يناير3،2021 2 53 1
الإثنين،يناير4،2021 2 1 1
الثلاثاء،يناير،52021 2 1 1
الأربعاء،يناير،62021 2 1 2
الخميس،يناير،72021 2 1 2
السبت،ديسمبر25،2021 52 51 52
الأحد،ديسمبر26،2021 53 51 52
الإثنين،ديسمبر27،2021 53 52 52
الثلاثاء،ديسمبر28،2021 53 52 52
الأربعاء،ديسمبر29،2021 53 52 53
الخميس،ديسمبر30،2021 53 52 53
الجمعة،ديسمبر31،2021 53 52 53