التواريخ والأوقات في SQLite: strftime و date و datetime

SQLite لا يملك نوع بيانات للتاريخ فعليًا

هذه النقطة تربك كل من يأتي من Postgres أو MySQL. فـ SQLite يملك خمس فئات تخزين فقط: NULL وINTEGER وREAL وTEXT وBLOB، ولا شيء غير ذلك. لا يوجد DATE ولا DATETIME ولا TIMESTAMP. يمكنك أن تكتب created_at DATETIME داخل جملة CREATE TABLE وسيقبلها SQLite دون اعتراض، لكنه في النهاية يخزّن القيمة كنص عادي أو كرقم.

ما يقدّمه لك SQLite بدلًا من ذلك هو مجموعة من دوال التاريخ تفهم ثلاث صيغ متعارف عليها لتخزين التاريخ في sqlite:

• نص بصيغة ISO 8601 — مثل '2026-04-23' أو '2026-04-23 10:15:00' أو '2026-04-23T10:15:00.123Z'.
• Unix timestamp — عدد الثواني منذ 1970-01-01 بتوقيت UTC، ويُخزَّن كعدد صحيح.
• رقم اليوم اليولياني (Julian day) — عدد الأيام الكسرية منذ سنة 4714 ق.م، ويُخزَّن كعدد عشري.

اختر صيغة واحدة والتزم بها. صيغة ISO 8601 النصية هي الأوضح للقراءة، كما أنها تُرتَّب ترتيبًا صحيحًا حتى عند معاملتها كنص، ولهذا تُعدّ الخيار الافتراضي.

SELECT date('now'),
       datetime('now'),
       strftime('%s', 'now'),
       julianday('now');

أربع طرق للسؤال عن "اللحظة الحالية" — تاريخ نصي، تاريخ ووقت نصي، ثوانٍ Unix، ويوم Julian. كلها تصف اللحظة نفسها.

دوال التاريخ الخمس في sqlite

يوفّر لك SQLite خمس دوال مدمجة تغطّي تقريبًا كل ما تحتاجه عند التعامل مع التواريخ:

• date(time, ...) — تُرجع التاريخ بصيغة YYYY-MM-DD.
• time(time, ...) — تُرجع الوقت بصيغة HH:MM:SS.
• datetime(time, ...) — تجمع الاثنين معًا بصيغة YYYY-MM-DD HH:MM:SS.
• julianday(time, ...) — تُرجع رقمًا عشريًا (مفيد جدًا لحساب الفرق بين تاريخين).
• strftime(format, time, ...) — تُرجع نصًا بتنسيق التاريخ الذي تختاره أنت.

كل دالة من هذه الدوال تستقبل قيمة زمنية كوسيط أول، ثم أي عدد تريده من المُعدِّلات (modifiers) النصية بعد ذلك.

SELECT date('2026-04-23 10:15:00')          AS just_date,
       time('2026-04-23 10:15:00')          AS just_time,
       datetime(1745402100, 'unixepoch')    AS from_unix,
       julianday('2026-04-23')              AS julian;

لاحظ كلمة 'unixepoch' — بهذه الكلمة تُخبر دوال التاريخ أن الرقم المُدخل هو Unix timestamp وليس يوماً جوليانياً. بدونها، يفترض SQLite أن الرقم بصيغة Julian.

strftime: تنسيق التاريخ في sqlite حسب رغبتك

دالة strftime هي حصان العمل الحقيقي. ترموز % فيها هي نفسها التي تعرفها من لغة C أو Python:

SELECT strftime('%Y-%m-%d',           'now') AS iso_date,
       strftime('%d/%m/%Y',           'now') AS european,
       strftime('%H:%M',              'now') AS hours_minutes,
       strftime('%Y-%m-%dT%H:%M:%fZ', 'now') AS iso_with_ms,
       strftime('%w',                 'now') AS day_of_week,
       strftime('%j',                 'now') AS day_of_year;

الرموز التي بتستخدمها أكثر شي:

• %Y — السنة بأربع خانات.
• %m — الشهر (01-12).
• %d — اليوم من الشهر (01-31).
• %H, %M, %S — الساعات والدقائق والثواني.
• %w — يوم الأسبوع (0=الأحد).
• %j — اليوم من السنة (001-366).
• %s — توقيت Unix (timestamp).
• %f — الكسور من الثانية (SS.SSS).

أيضاً strftime هي الطريقة التي بتستخرج فيها أجزاء من التاريخ — ما في دالة منفصلة اسمها EXTRACT ولا YEAR() زي بقية قواعد البيانات. بكل بساطة بتنسّق التاريخ لحد الجزء التي بدك إياه، وبتعمل cast لو محتاج قيمة رقمية:

SELECT strftime('%Y', '2026-04-23') AS year_text,
       CAST(strftime('%Y', '2026-04-23') AS INTEGER) AS year_num,
       CAST(strftime('%m', '2026-04-23') AS INTEGER) AS month_num;

strftime تُرجع دائمًا نصًا، لذا غلّفها بـ CAST(... AS INTEGER) إذا أردت إجراء عمليات حسابية أو مقارنات رقمية.

المُعدِّلات: حسابات التواريخ دون الحاجة إلى عوامل

هذه هي الميزة التي تجعل التعامل مع التواريخ في sqlite أمرًا ممتعًا. بعد وسيط الوقت، يمكنك تمرير أي عدد تشاء من سلاسل المُعدِّلات (modifiers)، وتُطبَّق بالترتيب الذي كتبتها به:

SELECT date('2026-04-23', '+7 days')              AS week_later,
       date('2026-04-23', '-1 month')             AS month_earlier,
       datetime('now', '+2 hours', '+30 minutes') AS in_two_thirty,
       date('now', 'start of month')              AS first_of_month,
       date('now', 'start of month', '+1 month', '-1 day') AS last_of_month,
       date('now', 'weekday 0')                   AS next_sunday;

المُعدِّلات (modifiers) التي ستستخدمها باستمرار:

• '+N days' و '-N days'، وكذلك الأمر مع hours وminutes وseconds وmonths وyears.
• 'start of day' و'start of month' و'start of year' — لاقتطاع التاريخ إلى بداية تلك الفترة.
• 'weekday N' — للانتقال إلى أقرب يوم محدد من أيام الأسبوع (0 = الأحد).
• 'localtime' و'utc' — للتحويل بين المناطق الزمنية.

حيلة "آخر يوم في الشهر" تستحق أن تحفظها: ابدأ من بداية الشهر، أضف شهراً واحداً، ثم اطرح يوماً واحداً. لا توجد في SQLite دالة باسم LAST_DAY، لكن سَلسَلة المُعدِّلات تعطيك النتيجة نفسها بالضبط.

التوقيت العالمي UTC مقابل التوقيت المحلي

'now' تُرجع دائماً التوقيت العالمي UTC. إذا أردت الوقت المحلي، فعليك طلبه صراحةً:

SELECT datetime('now')              AS utc_now,
       datetime('now', 'localtime') AS local_now,
       datetime('2026-04-23 10:00:00', 'utc') AS treated_as_local_then_utc;

المُعدِّل 'localtime' يحوّل القيمة من UTC إلى المنطقة الزمنية المحلية للنظام. أما المُعدِّل 'utc' فيعمل بالعكس تمامًا — يعتبر المُدخل بالتوقيت المحلي ويحوّله إلى UTC.

العادة الآمنة: خزّن كل شيء بصيغة UTC، ولا تحوّل إلى التوقيت المحلي إلا عند العرض فقط. خلط المناطق الزمنية في التخزين يفتح الباب لأخطاء تظهر مرتين في السنة مع تغيير التوقيت الصيفي.

مقارنة التواريخ وتصفية النطاقات في sqlite

إذا خزّنت التواريخ كنصوص بصيغة ISO 8601، فإن المقارنة و BETWEEN ستعملان دون أي عناء — لأن ISO 8601 يُرتَّب أبجديًا بنفس الترتيب الزمني تمامًا. وهذا بالضبط هو السبب وراء اعتماده كصيغة افتراضية في sqlite.

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL  -- ISO 8601
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   '2026-04-01 09:30:00'),
    ('Boris', '2026-04-15 14:00:00'),
    ('Carla', '2026-04-23 11:45:00'),
    ('Dmitri','2026-05-02 08:15:00');

SELECT customer, placed_at
FROM orders
WHERE placed_at >= '2026-04-01'
  AND placed_at <  '2026-05-01'
ORDER BY placed_at;

النطاق نصف المفتوح (>= start و < end) عادة مفيدة جدًا، لأنه يريحك تمامًا من السؤال المزعج: "هل منتصف ليل اليوم الثلاثين دخل ضمن النطاق ولا لأ؟".

وعشان تجيب بيانات "آخر 7 أيام"، خلّ SQLite هي التي تحسب لك الحد:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   datetime('now', '-2 days')),
    ('Boris', datetime('now', '-10 days')),
    ('Carla', datetime('now', '-1 day')),
    ('Dmitri',datetime('now', '-30 days'));

SELECT customer, placed_at
FROM orders
WHERE placed_at >= datetime('now', '-7 days')
ORDER BY placed_at DESC;

حساب الفرق بين تاريخين في SQLite

ما فيه دالة DATEDIFF في SQLite، لكن في طريقتين تغطّيان كل الحالات تقريبًا:

SELECT julianday('2026-04-23') - julianday('2026-04-01')           AS days_between,
       (julianday('2026-04-23 18:00') - julianday('2026-04-23 09:00')) * 24 AS hours_between,
       strftime('%s', '2026-04-23 18:00') - strftime('%s', '2026-04-23 09:00') AS seconds_between;

الفروقات الناتجة عن julianday() تكون بالأيام (مع دقة كسرية)، فلو ضربتها في 24 تحصل على الساعات، وفي 1440 تحصل على الدقائق. أما الفروقات بـ strftime('%s', ...) فتأتي بالثواني، وهذا مفيد لما تحتاج قيمة عددية صحيحة.

CAST(... AS INTEGER) يقطع الجزء الكسري من الأيام إذا أردت عدد الأيام الكامل فقط:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   datetime('now', '-2 days')),
    ('Boris', datetime('now', '-10 days')),
    ('Carla', datetime('now', '-1 day')),
    ('Dmitri',datetime('now', '-30 days'));

SELECT customer,
       CAST(julianday('now') - julianday(placed_at) AS INTEGER) AS days_ago
FROM orders
ORDER BY days_ago;

تخزين التاريخ في sqlite: اختر صيغة واحدة والتزم بها

أمامك ثلاث خيارات معقولة، مرتبة حسب الأولوية في الاختيار:

1. نص بصيغة ISO 8601 (TEXT). مقروء عند تصدير البيانات، يُرتَّب بشكل صحيح، ويتعامل بسلاسة مع كل دوال التاريخ. هذا هو الخيار الافتراضي.
2. ثوانٍ يونكس (INTEGER). حجم أصغر، ومقارنات أسرع، وبدون أي لبس في المنطقة الزمنية. مناسب حين يكون لديك ملايين الصفوف. ستحتاج إلى datetime(col, 'unixepoch') لقراءته بصيغة مفهومة.
3. اليوم اليولياني (REAL). نادراً ما يستحق العناء، إلا إذا كنت تقوم بحسابات تاريخية مكثفة وتريد دقة دون الثانية في عمود واحد.

أما ما يجب عليك تجنّبه تماماً فهو خلط الصيغ داخل العمود نفسه. صحيح أن دوال التاريخ ستقبل أي صيغة بصمت، لكن الفهارس والترتيب والمقارنات ستعطيك نتائج لا معنى لها.

-- القيم الافتراضية التي تُملأ تلقائيًا عند الإدراج:
CREATE TABLE events (
    id          INTEGER PRIMARY KEY,
    name        TEXT NOT NULL,
    happened_at TEXT NOT NULL DEFAULT (datetime('now'))
);

INSERT INTO events (name) VALUES ('تسجيل اشتراك'), ('تسجيل دخول');

SELECT name, happened_at FROM events;

DEFAULT (datetime('now')) هي المُعادِل في SQLite لِـ DEFAULT CURRENT_TIMESTAMP، فهي تختم كل صف جديد بالوقت الحالي بتوقيت UTC تلقائيًا، دون الحاجة لأي تدخل من جهة التطبيق.

تجميع البيانات حسب الفترة الزمنية

تظهر قوة strftime فعليًا حين تريد تجميع الصفوف حسب الشهر أو الأسبوع أو الساعة:

CREATE TABLE orders (
    id         INTEGER PRIMARY KEY,
    customer   TEXT,
    placed_at  TEXT NOT NULL
);

INSERT INTO orders (customer, placed_at) VALUES
    ('Ada',   '2026-04-01 09:30:00'),
    ('Boris', '2026-04-15 14:00:00'),
    ('Carla', '2026-04-23 11:45:00'),
    ('Dmitri','2026-05-02 08:15:00'),
    ('Ezra',  '2026-05-20 17:00:00');

SELECT strftime('%Y-%m', placed_at) AS month,
       COUNT(*)                     AS order_count
FROM orders
GROUP BY month
ORDER BY month;

نفس الفكرة تنطبق على "الطلبات حسب ساعة اليوم"، أو "التسجيلات حسب يوم الأسبوع"، أو "الأحداث في كل دقيقة" — اختر صيغة تنسيق تلتقط مستوى التفصيل الذي تريده فقط، ثم جمّع البيانات بناءً عليها.

التالي: دوال التجميع

وبما أننا نتحدث عن التجميع — فإن COUNT(*) هي أبسط دوال التجميع في SQLite. في الدرس القادم سنستعرض المجموعة الكاملة: SUM، وAVG، وMIN، وMAX، وكيف تختصر هذه الدوال صفوفاً كثيرة إلى قيمة ملخّصة واحدة.