.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, David Metcalfe .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH tzset 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم tzset, tzname, timezone, daylight \- دالة تهيئة معلومات تحويل الوقت .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBvoid tzset(void);\fP .P \fBextern char *\fP\fItzname\fP\fB[2];\fP \fBextern long \fP\fItimezone\fP\fB;\fP \fBextern int \fP\fIdaylight\fP\fB;\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBtzset\fP(): .nf _POSIX_C_SOURCE .fi .P \fItzname\fP: .nf _POSIX_C_SOURCE .fi .P \fItimezone\fP, \fIdaylight\fP: .nf _XOPEN_SOURCE || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE .fi .SH الوصف الدالة \fBtzset\fP() تهيئ المتغير \fItzname\fP من متغير البيئة \fBTZ\fP. تُستدعى هذه الدالة آليًا بواسطة دوال تحويل الوقت الأخرى التي تعتمد على المنطقة الزمنية. في بيئة شبيهة بـ System\-V، ستُعيِّن أيضًا المتغيرين \fItimezone\fP (بالثواني غرب UTC) و \fIdaylight\fP (إلى 0 إذا لم تكن لهذه المنطقة الزمنية قواعد توقيت صيفي، أو إلى قيمة غير صفرية إذا كان هناك وقت، ماضٍ أو حاضر أو مستقبل، يُطبق فيه التوقيت الصيفي). .P الدالة \fBtzset\fP() تهيئ هذه المتغيرات إلى قيم غير محددة إذا كانت هذه المنطقة الزمنية منطقة زمنية جغرافية مثل "America/New_York" (انظر أدناه). .P إذا لم يظهر المتغير \fBTZ\fP في البيئة، تُستخدم المنطقة الزمنية للنظام. تُهيَّأ المنطقة الزمنية للنظام بنسخ أو ربط ملف بصيغة \fBtzfile\fP(5) إلى \fI/etc/localtime\fP. قد توجد قاعدة بيانات للمناطق الزمنية لهذه الملفات في دليل المناطق الزمنية للنظام (انظر قسم \fBFILES\fP أدناه). .P إذا ظهر المتغير \fBTZ\fP في البيئة، لكن قيمته فارغة، أو لا يمكن تفسير قيمته باستخدام أي من الصيغ المحددة أدناه، فسيُستخدم التوقيت العالمي المنسق (UTC). .P يمكن أن تكون القيمة غير الفارغة لـ \fBTZ\fP واحدة من صيغتين، يمكن أن تسبق أي منهما بنقطتين رأسيتين يتم تجاهلهما. الصيغة الأولى هي سلسلة محارف تمثل مباشرة المنطقة الزمنية المراد استخدامها: .P .in +4n .EX \fIstd offset\fP[\fIdst\fP[\fIoffset\fP][,\fIstart\fP[\fI/time\fP],\fIend\fP[\fI/time\fP]]] .EE .in .P لا توجد مسافات في المواصفات. تحدد سلسلة المحارف \fIstd\fP اختصارًا للمنطقة الزمنية ويجب أن تتكون من ثلاثة أحرف أبجدية أو أكثر. عندما تُحصر بين علامتي أقل من (<) وأكبر من (>)، تتوسع مجموعة المحارف لتشمل علامة الجمع (+) وعلامة الطرح (\-) والأرقام. تتبع سلسلة المحارف \fIoffset\fP مباشرة \fIstd\fP وتحدد قيمة الوقت المراد إضافتها إلى الوقت المحلي للحصول على التوقيت العالمي المنسق (UTC). تكون \fIoffset\fP موجبة إذا كانت المنطقة الزمنية المحلية غرب خط الطول الرئيسي وسالبة إذا كانت شرقه. يجب أن تكون الساعة بين 0 و24، والدقائق والثواني بين 00 و59: .P .in +4n .EX [\fI+\fP|\fI\-\fP]\fIhh\fP[\fI:mm\fP[\fI:ss\fP]] .EE .in .P تحدد سلسلة المحارف \fIdst\fP و \fIoffset\fP الاسم والإزاحة للمنطقة الزمنية الصيفية المقابلة. إذا حُذفت الإزاحة، فستكون مبدئيًا قبل التوقيت القياسي بساعة واحدة. .P يحدد الحقل \fIstart\fP متى يدخل التوقيت الصيفي حيز التنفيذ، ويحدد الحقل \fIend\fP متى يُجرى التغيير عائدًا إلى التوقيت القياسي. قد تكون لهذه الحقول الصيغ التالية: .TP J\fIn\fP يحدد هذا اليوم اليولياني مع \fIn\fP بين 1 و365. لا تُحتسب أيام الكبس. في هذه الصيغة، لا يمكن تمثيل 29 فبراير؛ 28 فبراير هو اليوم 59، و1 مارس هو دائمًا اليوم 60. .TP \fIn\fP يحدد هذا اليوم اليولياني ذا الأساس الصفري مع \fIn\fP بين 0 و365. يُحتسب 29 فبراير في السنوات الكبيسة. .TP M\fIm\fP.\fIw\fP.\fId\fP يُحدد هذا اليوم \fId\fP (0\ <= \fId\fP\ <= 6) من الأسبوع \fIw\fP (1\ <= \fIw\fP\ <= 5) من الشهر \fIm\fP (1\ <= \fIm\fP\ <= 12). الأسبوع 1 هو أول أسبوع يحدث فيه اليوم \fId\fP والأسبوع 5 هو آخر أسبوع يحدث فيه اليوم \fId\fP. اليوم 0 هو الأحد. .P تحدد حقول \fItime\fP متى، في التوقيت المحلي الساري حالياً، يحدث التغيير إلى التوقيت الآخر. تستخدم نفس تنسيق \fIoffset\fP باستثناء أن الساعة يمكن أن تكون في النطاق [\fB\-167\fP,\ \fB167\fP] لتمثيل الأوقات قبل وبعد اليوم المسمى. إذا حُذفت، فالمبدئي هو 02:00:00. .P هذا مثال لنيوزيلندا، حيث التوقيت القياسي (NZST) يسبق UTC بـ12 ساعة، والتوقيت الصيفي (NZDT)، يسبق UTC بـ13 ساعة، يمتد من آخر أحد في سبتمبر، في الوقت المبدئي 02:00:00، إلى أول أحد في أبريل عند 03:00:00. .P .in +4n .EX TZ="NZST\-12:00:00NZDT\-13:00:00,M9.5.0,M4.1.0/3" .EE .in .P التنسيق الثاني \[em]أو "الجغرافي"\[em] يحدد أن معلومات المنطقة الزمنية يجب أن تُقرأ من ملف: .P .in +4n .EX filespec .EE .in .P يحدد \fIfilespec\fP ملفاً بتنسيق \fBtzfile\fP(5) لقراءة معلومات المنطقة الزمنية منه. إذا لم يبدأ \fIfilespec\fP بـ \[aq]\fB/\fP\[aq]، فإن مواصفات الملف تكون نسبية لدليل المنطقة الزمنية للنظام. إذا تعذرت قراءة الملف المحدد أو تفسيره، يُستخدم التوقيت العالمي المنسق (UTC)؛ ومع ذلك، لا ينبغي للتطبيقات الاعتماد على قيم \fIfilespec\fP عشوائية لتمثيل UTC، حيث قد تُوسع تنسيقات \fBTZ\fP في المستقبل. .P هذا مثال، مرة أخرى لنيوزيلندا: .P .in +4n .EX TZ="Pacific/Auckland" .EE .in .SH البيئة .TP \fBTZ\fP إذا عُيّن هذا المتغير، فإن قيمته لها الأولوية على المنطقة الزمنية المكونة للنظام. .TP \fBTZDIR\fP إذا عُيّن هذا المتغير، فإن قيمته لها الأولوية على مسار دليل قاعدة بيانات المنطقة الزمنية المكونة للنظام. .SH الملفات .TP \fI/etc/localtime\fP ملف المنطقة الزمنية للنظام. .TP \fI/usr/share/zoneinfo/\fP دليل قاعدة بيانات المنطقة الزمنية للنظام. .TP \fI/usr/share/zoneinfo/posixrules\fP عندما تتضمن سلسلة TZ منطقة زمنية للتوقيت الصيفي دون أي شيء يتبعها، يُستخدم هذا الملف لقواعد البداية/النهاية. هو بتنسيق \fBtzfile\fP(5). مبدئياً، يقوم Makefile الخاص بـ zoneinfo بربطه بشكل ثابت بملف tzfile \fIAmerica/New_York\fP. .P ما سبق هو مواقع الملفات القياسية الحالية، لكنها قابلة للتكوين عند تجميع glibc. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBtzset\fP() T} سلامة الخيوط بيئة محلية آمنة لتعدد الخيوط (MT\-Safe) .TE .SH المعايير POSIX.1\-2024. .SH التاريخ .TP \fBtzset\fP() .TQ \fItzname\fP POSIX.1\-1988, SVr4, 4.3BSD. .TP \fItimezone\fP .TQ \fIdaylight\fP POSIX.1\-2001 (XSI), SVr4, 4.3BSD. .P احتوت 4.3BSD على دالة \fBchar *timezone(\fP\fIzone\fP\fB, \fP\fIdst\fP\fB)\fP أعادت اسم المنطقة الزمنية المطابقة لوسيطها الأول (بالدقائق غرب UTC). إذا كان الوسيط الثاني 0، استُخدم الاسم القياسي، وإلا استُخدم إصدار التوقيت الصيفي. .SH تحذيرات لأن قيم \fItzname\fP و\fItimezone\fP و\fIdaylight\fP غالبًا ما تكون غير محددة، وقد يؤدي الوصول إليها إلى سلوك غير محدد في التطبيقات متعددة الخيوط، ينبغي للكود بدلاً من ذلك الحصول على إزاحة المنطقة الزمنية واختصاراتها من العضوين \fItm_gmtoff\fP و\fItm_zone\fP في بنية الوقت المفصلة \fBtm\fP(3type). .SH العلل بما أن هذه الدالة لا تُبلغ عن الأخطاء، فلا توجد طريقة لمعرفة ما إذا كانت قيمة TZ تمثل منطقة زمنية صالحة. .SH "انظر أيضًا" \fBdate\fP(1), \fBgettimeofday\fP(2), \fBtime\fP(2), \fBctime\fP(3), \fBgetenv\fP(3), \fBtzfile\fP(5) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .