Bitbybit Docs
    Preparing search index...

    Class Dates

    التواريخ والأوقات كقيم Date في JavaScript: إنشاؤها، وقراءة أجزائها وضبطها، وتنسيقها كنص. تبدأ الشهور من 0 (يناير 0 وديسمبر 11) وأيام الأسبوع من 0 (الأحد)؛ وتبدأ أيام الشهر من 1. تعيد كل دالة ضبط تاريخا جديدا وتترك التاريخ المعطى دون تغيير. توجد متغيرات بالتوقيت المحلي و UTC لمعظم العمليات.

    Index

    Constructors

    constructor

    convert

    toDateString toISOString toJSON toString toTimeString toUTCString

    create

    now createDate createDateUTC createFromUnixTimeStamp

    get

    getDayOfMonth getWeekday getYear getMonth getHours getMinutes getSeconds getMilliseconds getTime getUTCYear getUTCMonth getUTCDay getUTCHours getUTCMinutes getUTCSeconds getUTCMilliseconds

    parse

    parseDate

    set

    setYear setMonth setDayOfMonth setHours setMinutes setSeconds setMilliseconds setTime setUTCYear setUTCMonth setUTCDay setUTCHours setUTCMinutes setUTCSeconds setUTCMilliseconds

    Constructors

    convert

    • ينسق جزء التاريخ كنص، دون الوقت، بالمنطقة الزمنية المحلية.

      مثال: 15 يناير 2024 الساعة 14:30 -> 'Mon Jan 15 2024'

      Parameters

      Returns string

      التاريخ كنص مثل 'Mon Jan 15 2024'

    • ينسق التاريخ والوقت بصيغة ISO 8601 المستخدمة لتبادل البيانات، دائما بالتوقيت العالمي المنسق UTC.

      مثال: 15 يناير 2024 الساعة 14:30 -> '2024-01-15T14:30:45.000Z'

      Parameters

      Returns string

      التاريخ كنص مثل '2024-01-15T14:30:45.000Z'

    • ينسق التاريخ بالطريقة التي يظهر بها داخل JSON، وهي صيغة ISO 8601 بالتوقيت العالمي المنسق UTC.

      مثال: 15 يناير 2024 الساعة 14:30 -> '2024-01-15T14:30:00.000Z'

      Parameters

      Returns string

      التاريخ كنص مثل '2024-01-15T14:30:00.000Z'

    • ينسق التاريخ والوقت كاملين كنص بالمنطقة الزمنية المحلية، مع إزاحة المنطقة.

      مثال: 15 يناير 2024 الساعة 14:30 -> 'Mon Jan 15 2024 14:30:00 GMT+0000'

      Parameters

      Returns string

      التاريخ والوقت كنص

    • ينسق جزء الوقت كنص، دون التاريخ، بالمنطقة الزمنية المحلية مع إزاحة المنطقة.

      مثال: 15 يناير 2024 الساعة 14:30 -> '14:30:45 GMT+0000'

      Parameters

      Returns string

      الوقت كنص مثل '14:30:45 GMT+0000'

    • ينسق التاريخ والوقت كنص بالتوقيت العالمي المنسق UTC.

      مثال: 15 يناير 2024 الساعة 14:30 -> 'Mon, 15 Jan 2024 14:30:00 GMT'

      Parameters

      Returns string

      التاريخ والوقت كنص UTC

    create

    • يعطي التاريخ والوقت الحاليين لحظة الاستدعاء.

      Returns Date

      التاريخ والوقت الحاليان

    • يبني تاريخا من أجزائه، مقروءة بالمنطقة الزمنية المحلية.

      يبدأ عد الشهر من 0: 0 هو يناير، و 11 ديسمبر. الجزء الخارج عن نطاقه يرحّل، فيصبح اليوم 32 من يناير الأول من فبراير. مثال: السنة 2024، الشهر 0، اليوم 15، الساعات 14، الدقائق 30 -> 15 يناير 2024 الساعة 14:30 بالتوقيت المحلي

      Parameters

      • inputs: CreateDateDto

        السنة والشهر واليوم والساعات والدقائق والثواني والمللي ثانية

      Returns Date

      التاريخ

      const date = bitbybit.dates.createDate({ year: 2024, month: 0, day: 15, hours: 14, minutes: 30, seconds: 0, milliseconds: 0 });

    • يبني تاريخا من أجزائه، مقروءة بالتوقيت العالمي المنسق UTC بحيث لا دور للمنطقة الزمنية المحلية.

      يبدأ عد الشهر من 0: 0 هو يناير، و 11 ديسمبر. الجزء الخارج عن نطاقه يرحّل. مثال: السنة 2024، الشهر 0، اليوم 15 -> 15 يناير 2024 الساعة 00:00 UTC

      Parameters

      • inputs: CreateDateDto

        السنة والشهر واليوم والساعات والدقائق والثواني والمللي ثانية

      Returns Date

      التاريخ

      const date = bitbybit.dates.createDateUTC({ year: 2024, month: 0, day: 15, hours: 0, minutes: 0, seconds: 0, milliseconds: 0 });

    • يبني تاريخا من طابع زمني Unix: عدد الميلي ثانية منذ 1 يناير 1970 الساعة 00:00 UTC.

      مثال: 1705329000000 -> 15 يناير 2024 الساعة 14:30 UTC

      Parameters

      Returns Date

      التاريخ

      const date = bitbybit.dates.createFromUnixTimeStamp({ unixTimeStamp: 1705329000000 });

    get

    • يقرأ يوم الشهر، من 1 إلى 31، بالمنطقة الزمنية المحلية.

      مثال: 15 يناير 2024 -> 15

      Parameters

      Returns number

      اليوم من الشهر

    • يقرأ يوم الأسبوع بالمنطقة الزمنية المحلية: 0 هو الأحد، و 6 السبت.

      مثال: 15 يناير 2024 -> 1، يوم اثنين

      Parameters

      Returns number

      يوم الأسبوع من 0 إلى 6

    • يقرأ السنة الكاملة بالمنطقة الزمنية المحلية.

      مثال: 15 يناير 2024 -> 2024

      Parameters

      Returns number

      السنة

    • يقرأ الشهر بالمنطقة الزمنية المحلية، بدءا من 0: 0 هو يناير، و 11 ديسمبر.

      مثال: 15 يناير 2024 -> 0

      Parameters

      Returns number

      الشهر من 0 إلى 11

    • يقرأ الساعة، من 0 إلى 23، بالمنطقة الزمنية المحلية.

      مثال: 14:30 -> 14

      Parameters

      Returns number

      الساعة

    • يقرأ الدقائق، من 0 إلى 59، بالمنطقة الزمنية المحلية.

      مثال: 14:30 -> 30

      Parameters

      Returns number

      الدقائق

    • يقرأ الثواني، من 0 إلى 59، بالمنطقة الزمنية المحلية.

      مثال: 14:30:45 -> 45

      Parameters

      Returns number

      الثواني

    • يقرأ الميلي ثانية، من 0 إلى 999، بالمنطقة الزمنية المحلية.

      مثال: 14:30:45.123 -> 123

      Parameters

      Returns number

      المللي ثانية

    • يعطي التاريخ كطابع زمني Unix: الميلي ثانية منذ 1 يناير 1970 الساعة 00:00 UTC.

      مثال: 15 يناير 2024 الساعة 14:30 UTC -> 1705329000000

      Parameters

      Returns number

      الطابع الزمني بالمللي ثانية

    • يقرأ السنة الكاملة بالتوقيت العالمي المنسق UTC.

      مثال: 15 يناير 2024 -> 2024

      Parameters

      Returns number

      السنة

    • يقرأ الشهر بالتوقيت العالمي المنسق UTC، بدءا من 0: 0 هو يناير، و 11 ديسمبر.

      مثال: 15 يناير 2024 -> 0

      Parameters

      Returns number

      الشهر من 0 إلى 11

    • يقرأ يوم الشهر، من 1 إلى 31، بالتوقيت العالمي المنسق UTC.

      مثال: 15 يناير 2024 -> 15

      Parameters

      Returns number

      اليوم من الشهر

    • يقرأ الساعة، من 0 إلى 23، بالتوقيت العالمي المنسق UTC.

      مثال: 14:00 UTC -> 14

      Parameters

      Returns number

      الساعة

    • يقرأ الدقائق، من 0 إلى 59، بالتوقيت العالمي المنسق UTC.

      مثال: 14:30 UTC -> 30

      Parameters

      Returns number

      الدقائق

    • يقرأ الثواني، من 0 إلى 59، بالتوقيت العالمي المنسق UTC.

      مثال: 14:30:45 UTC -> 45

      Parameters

      Returns number

      الثواني

    • يقرأ الميلي ثانية، من 0 إلى 999، بالتوقيت العالمي المنسق UTC.

      مثال: 14:30:45.123 UTC -> 123

      Parameters

      Returns number

      المللي ثانية

    parse

    • يقرأ تاريخا مكتوبا كنص ويعطي طابعه الزمني Unix، الميلي ثانية منذ 1 يناير 1970 الساعة 00:00 UTC.

      نص ISO 8601 مثل '2024-01-15' أو '2024-01-15T14:30:00Z' يُقرأ بشكل موثوق؛ والنص الذي لا يمكن قراءته يعطي NaN. مثال: '2024-01-15' -> 1705276800000

      Parameters

      Returns number

      الطابع الزمني بالمللي ثانية، أو NaN عندما لا يكون النص تاريخا

      const stamp = bitbybit.dates.parseDate({ dateString: "2024-01-15T14:30:00Z" });

    set

    • يصنع نسخة من التاريخ بسنة أخرى، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 بالسنة 2025 -> 15 يناير 2025

      Parameters

      Returns Date

      تاريخ جديد بسنة متغيرة

      const changed = bitbybit.dates.setYear({ date: bitbybit.dates.now(), year: 2025 });

    • يصنع نسخة من التاريخ بشهر آخر، بالمنطقة الزمنية المحلية؛ يبدأ عد الشهور من 0. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 بالشهر 5 -> 15 يونيو 2024

      Parameters

      • inputs: DateMonthDto

        التاريخ والشهر من 0 إلى 11

      Returns Date

      تاريخ جديد بشهر متغير

      const changed = bitbybit.dates.setMonth({ date: bitbybit.dates.now(), month: 5 });

    • يصنع نسخة من التاريخ بيوم آخر من الشهر، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 باليوم 20 -> 20 يناير 2024

      Parameters

      • inputs: DateDayDto

        التاريخ واليوم من 1 إلى 31

      Returns Date

      تاريخ جديد بيوم متغير

      const changed = bitbybit.dates.setDayOfMonth({ date: bitbybit.dates.now(), day: 20 });

    • يصنع نسخة من التاريخ بساعة أخرى، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 14:30 بالساعات 9 -> 09:30

      Parameters

      • inputs: DateHoursDto

        التاريخ والساعة من 0 إلى 23

      Returns Date

      تاريخ جديد بساعة متغيرة

      const changed = bitbybit.dates.setHours({ date: bitbybit.dates.now(), hours: 9 });

    • يصنع نسخة من التاريخ بدقائق أخرى، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 14:30 بالدقائق 45 -> 14:45

      Parameters

      • inputs: DateMinutesDto

        التاريخ والدقائق من 0 إلى 59

      Returns Date

      تاريخ جديد بدقائق متغيرة

      const changed = bitbybit.dates.setMinutes({ date: bitbybit.dates.now(), minutes: 45 });

    • يصنع نسخة من التاريخ بثوان أخرى، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 14:30:00 بالثواني 30 -> 14:30:30

      Parameters

      • inputs: DateSecondsDto

        التاريخ والثواني من 0 إلى 59

      Returns Date

      تاريخ جديد بثوان متغيرة

      const changed = bitbybit.dates.setSeconds({ date: bitbybit.dates.now(), seconds: 30 });

    • يصنع نسخة من التاريخ بميلي ثانية أخرى، بالمنطقة الزمنية المحلية. التاريخ المعطى لا يتغير.

      مثال: 14:30:00.000 بالميلي ثانية 500 -> 14:30:00.500

      Parameters

      Returns Date

      تاريخ جديد بمللي ثانية متغيرة

      const changed = bitbybit.dates.setMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });

    • يصنع نسخة من التاريخ منقولة إلى طابع زمني Unix، الميلي ثانية منذ 1 يناير 1970 الساعة 00:00 UTC. التاريخ المعطى لا يتغير.

      مثال: أي تاريخ بالوقت 0 -> 1 يناير 1970 الساعة 00:00 UTC

      Parameters

      • inputs: DateTimeDto

        التاريخ والطابع الزمني بالمللي ثانية

      Returns Date

      تاريخ جديد بطابع زمني متغير

      const changed = bitbybit.dates.setTime({ date: bitbybit.dates.now(), time: 1705329000000 });

    • يصنع نسخة من التاريخ بسنة أخرى، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 بالسنة 2025 -> 15 يناير 2025

      Parameters

      Returns Date

      تاريخ جديد بسنة متغيرة

      const changed = bitbybit.dates.setUTCYear({ date: bitbybit.dates.now(), year: 2025 });

    • يصنع نسخة من التاريخ بشهر آخر، بالتوقيت العالمي المنسق UTC؛ يبدأ عد الشهور من 0. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 بالشهر 5 -> 15 يونيو 2024

      Parameters

      • inputs: DateMonthDto

        التاريخ والشهر من 0 إلى 11

      Returns Date

      تاريخ جديد بشهر متغير

      const changed = bitbybit.dates.setUTCMonth({ date: bitbybit.dates.now(), month: 5 });

    • يصنع نسخة من التاريخ بيوم آخر من الشهر، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 15 يناير 2024 باليوم 20 -> 20 يناير 2024

      Parameters

      • inputs: DateDayDto

        التاريخ واليوم من 1 إلى 31

      Returns Date

      تاريخ جديد بيوم متغير

      const changed = bitbybit.dates.setUTCDay({ date: bitbybit.dates.now(), day: 20 });

    • يصنع نسخة من التاريخ بساعة أخرى، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 14:30 UTC بالساعات 9 -> 09:30 UTC

      Parameters

      • inputs: DateHoursDto

        التاريخ والساعة من 0 إلى 23

      Returns Date

      تاريخ جديد بساعة متغيرة

      const changed = bitbybit.dates.setUTCHours({ date: bitbybit.dates.now(), hours: 9 });

    • يصنع نسخة من التاريخ بدقائق أخرى، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 14:30 UTC بالدقائق 45 -> 14:45 UTC

      Parameters

      • inputs: DateMinutesDto

        التاريخ والدقائق من 0 إلى 59

      Returns Date

      تاريخ جديد بدقائق متغيرة

      const changed = bitbybit.dates.setUTCMinutes({ date: bitbybit.dates.now(), minutes: 45 });

    • يصنع نسخة من التاريخ بثوان أخرى، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 14:30:00 UTC بالثواني 30 -> 14:30:30 UTC

      Parameters

      • inputs: DateSecondsDto

        التاريخ والثواني من 0 إلى 59

      Returns Date

      تاريخ جديد بثوان متغيرة

      const changed = bitbybit.dates.setUTCSeconds({ date: bitbybit.dates.now(), seconds: 30 });

    • يصنع نسخة من التاريخ بميلي ثانية أخرى، بالتوقيت العالمي المنسق UTC. التاريخ المعطى لا يتغير.

      مثال: 14:30:00.000 UTC بالميلي ثانية 500 -> 14:30:00.500 UTC

      Parameters

      Returns Date

      تاريخ جديد بمللي ثانية متغيرة

      const changed = bitbybit.dates.setUTCMilliseconds({ date: bitbybit.dates.now(), milliseconds: 500 });

    Settings

    Member Visibility

    On This Page

    Constructors
    convert
    create
    get
    parse
    set