DateTime
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
| تمثيل JSON |
{
"date": string
} |
| الحقول |
date |
string
التاريخ/الوقت بتنسيق ISO 8601 الممتد. قد تكون الإزاحة مطلوبة أو لا تكون مطلوبة (راجع وثائق الحقل الرئيسي). يمكن تحديد الوقت بدقة تصل إلى نانو ثانية. يمكن تحديد الإزاحة بدقة بالثواني (على الرغم من أن ثوانٍ الإزاحة ليست جزءًا من ISO 8601). على سبيل المثال: ستكون 1985-04-12T23:20:50.52Z بعد 20 دقيقة و50.52 ثانية من الساعة 23 من 12 نيسان (أبريل) 1985 بالتوقيت العالمي المنسق. 1985-04-12T19:20:50.52-04:00 ستكون 20 دقيقة و50.52 ثانية بعد الساعة 19 من 12 نيسان (أبريل) 1985، قبل 4 ساعات من التوقيت العالمي المنسَّق (UTC) (الوقت الفعلي نفسه كما في المثال أعلاه). إذا كان التاريخ/الوقت مخصّصًا لموقع جغرافي في مدينة أبوظبي، سيكون هذا التاريخ معادلاً بالتوقيت الصيفي الشرقي (EDT). تذكر أن التوقيت يختلف في المناطق التي تطبّق التوقيت الصيفي (أو التوقيت الصيفي)، بناءً على الوقت من السنة.
ستكون 1985-04-12T19:20:50.52 بعد 20 دقيقة و50.52 ثانية من الساعة 19 من 12 نيسان (أبريل) 1985 بدون أي معلومات إزاحة. وتوفير إزاحة يجعل هذه المهمة لحظة مطلقة في وقت محدّد حول العالم. وسيتم تعديل التاريخ/الوقت استنادًا إلى المنطقة الزمنية للمستخدم. على سبيل المثال، سيكون توقيت 2018-06-19T18:30:00-04:00 هو 18:30:00 لمستخدم في نيويورك و15:30:00 للمستخدم في لوس أنجلوس. إغفال الإزاحة يجعل هذا التاريخ/الوقت محليًا، وهو يمثل عدة مراحل في الزمن حول العالم. سيبقى التاريخ/الوقت دائمًا في المنطقة الزمنية الحالية للمستخدِم. على سبيل المثال، سيكون توقيت 2018-06-19T18:30:00 هو 18:30:00 لمستخدم في نيويورك و18:30:00 للمستخدم في لوس أنجلوس. ويُفيد ذلك عندما يكون التاريخ/الوقت المحلي نفسه ينطبق على العديد من المواقع الجغرافية الفعلية في عدة مناطق زمنية.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe JSON schema represents a date object.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edate\u003c/code\u003e field is a string that adheres to the ISO 8601 extended format for date and time.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edate\u003c/code\u003e field can include an offset to specify the time zone, or it can be omitted for local time representation.\u003c/p\u003e\n"],["\u003cp\u003eProviding an offset ensures the \u003ccode\u003edate\u003c/code\u003e represents a specific instant in time globally, while omitting it makes it a local time subject to user time zones.\u003c/p\u003e\n"]]],["The core information defines the `date` field within a JSON structure. The `date` is a string representing an ISO 8601 date/time, with optional offset information. It may include nanosecond precision. Providing an offset creates an absolute instant in time, adjusted to the user's timezone. Omitting the offset creates a local date/time, consistent across time zones. This format can represent times down to the nanosecond and offsets with second precision.\n"],null,["# DateTime\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n\n| JSON representation |\n|----------------------------|\n| ``` { \"date\": string } ``` |\n\n| Fields ||\n|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `string` An ISO 8601 extended format date/time. Offset may or may not be required (refer to the parent field's documentation). Time may be specified up to nanosecond precision. Offsets may be specified with seconds precision (even though offset seconds is not part of ISO 8601). For example: `1985-04-12T23:20:50.52Z` would be 20 minutes and 50.52 seconds after the 23rd hour of April 12th, 1985 in UTC. `1985-04-12T19:20:50.52-04:00` would be 20 minutes and 50.52 seconds after the 19th hour of April 12th, 1985, 4 hours before UTC (same instant in time as the above example). If the date/time is intended for a physical location in New York, this would be the equivalent of Eastern Daylight Time (EDT). Remember that offset varies in regions that observe Daylight Saving Time (or Summer Time), depending on the time of the year. `1985-04-12T19:20:50.52` would be 20 minutes and 50.52 seconds after the 19th hour of April 12th, 1985 with no offset information. Providing an offset makes this an absolute instant in time around the world. The date/time will be adjusted based on the user's time zone. For example, a time of `2018-06-19T18:30:00-04:00` will be 18:30:00 for a user in New York and 15:30:00 for a user in Los Angeles. Omitting the offset makes this a local date/time, representing several instants in time around the world. The date/time will always be in the user's current time zone. For example, a time of `2018-06-19T18:30:00` will be 18:30:00 for a user in New York and also 18:30:00 for a user in Los Angeles. This is useful when the same local date/time should apply to many physical locations across several time zones. |"]]
