Package google.type

इंडेक्स

• DateTime (मैसेज)
• TimeOfDay (मैसेज)
• TimeZone (मैसेज)

DateTime

यह सिविल टाइम (या कभी-कभी फ़िज़िकल टाइम) को दिखाता है.

इस तरह के मामलों में, सिविल टाइम को इनमें से किसी एक तरीके से दिखाया जा सकता है:

• जब utc_offset सेट हो और time_zone सेट न हो: किसी कैलेंडर के दिन का सिविल टाइम, जो यूटीसी से किसी खास ऑफ़सेट पर होता है.
• जब time_zone सेट है और utc_offset सेट नहीं है, तो किसी खास टाइम ज़ोन में कैलेंडर के किसी दिन का सिविल टाइम.
• जब time_zone और utc_offset, दोनों को सेट नहीं किया जाता है: स्थानीय समय में, कैलेंडर के दिन का सिविल टाइम होता है.

यह तारीख, प्रोलेप्टिक ग्रेगोरियन कैलेंडर के हिसाब से है.

अगर साल, महीना या दिन 0 है, तो इसका मतलब है कि DateTime फ़ील्ड में साल, महीना या दिन की कोई वैल्यू नहीं है.

अगर तारीख और समय के सभी फ़ील्ड सेट हैं और time_offset oneof में से कोई एक केस सेट है, तो इस टाइप का इस्तेमाल किसी समय को दिखाने के लिए भी किया जा सकता है. इसके बजाय, समय बिताने के लिए Timestamp मैसेज का इस्तेमाल करें. अगर आपके इस्तेमाल के उदाहरण में उपयोगकर्ता के टाइमज़ोन को भी सेव करना है, तो उसे किसी दूसरे फ़ील्ड में सेव किया जा सकता है.

यह टाइप, कुछ ऐप्लिकेशन के हिसाब से ज़्यादा फ़्लेक्सिबल है. अपने आवेदन की सीमाओं का दस्तावेज़ बनाना और उनकी पुष्टि करना न भूलें.

फ़ील्ड
year	int32 ज़रूरी नहीं. तारीख का साल. 1 से 9999 तक होना चाहिए, या अगर साल के बिना तारीख और समय तय करना है, तो 0 होना चाहिए.
month	int32 ज़रूरी नहीं. वर्ष का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर महीने के बिना तारीख और समय दिया गया है, तो यह वैल्यू 0 होनी चाहिए.
day	int32 ज़रूरी नहीं. महीने का दिन. यह 1 से 31 के बीच की कोई संख्या होनी चाहिए. यह साल और महीने के लिए मान्य होनी चाहिए. अगर दिन के बिना तारीख और समय दिया गया है, तो यह 0 होनी चाहिए.
hours	int32 ज़रूरी नहीं. दिन के घंटे, 24 घंटे के फ़ॉर्मैट में. यह 0 से 23 के बीच होना चाहिए. डिफ़ॉल्ट रूप से, यह 0 (आधी रात) पर सेट होता है. कारोबार के बंद होने के समय जैसी स्थितियों के लिए, एपीआई "24:00:00" वैल्यू को अनुमति दे सकता है.
minutes	int32 ज़रूरी नहीं. दिन के घंटे के मिनट. यह वैल्यू 0 से 59 के बीच होनी चाहिए. डिफ़ॉल्ट रूप से, यह 0 पर सेट होती है.
seconds	int32 ज़रूरी नहीं. समय के मिनट के सेकंड. आम तौर पर, यह संख्या 0 से 59 होनी चाहिए और इसकी डिफ़ॉल्ट वैल्यू 0 होती है. अगर एपीआई में लीप-सेकंड की अनुमति है, तो वह 60 की वैल्यू को स्वीकार कर सकता है.
nanos	int32 ज़रूरी नहीं. सेकंड के छोटे से हिस्से को नैनोसेकंड में दिखाया जाता है. यह वैल्यू 0 से 999,999,999 के बीच होनी चाहिए. डिफ़ॉल्ट रूप से, यह 0 पर सेट होती है.
यूनियन फ़ील्ड time_offset. ज़रूरी नहीं. यह UTC ऑफ़सेट या DateTime के टाइम ज़ोन के बारे में बताता है. इनमें से किसी एक को चुनते समय ध्यान रखें कि आने वाले समय में टाइम ज़ोन का डेटा बदल सकता है. उदाहरण के लिए, कोई देश अपने डीएसटी की शुरुआत/खत्म होने की तारीखों में बदलाव कर सकता है. साथ ही, जिन तारीखों पर असर पड़ा है उनमें आने वाले समय के लिए, पहले से ही टाइमस्टैंप सेव हो सकते हैं. अगर यह एट्रिब्यूट नहीं दिया गया है, तो तारीख और समय को स्थानीय समय के हिसाब से माना जाता है. time_offset इनमें से कोई एक हो सकता है:
utc_offset	Duration यूटीसी से समय का अंतर. यह संख्या पूरी होनी चाहिए और -18 घंटे से +18 घंटे के बीच होनी चाहिए. उदाहरण के लिए, -4:00 के UTC ऑफ़सेट को { seconds: -14400 } के तौर पर दिखाया जाएगा.
time_zone	TimeZone टाइम ज़ोन.

TimeOfDay

दिन का समय दिखाता है. तारीख और टाइम ज़ोन कोई अहम नहीं है या उन्हें कहीं और बताया गया है. कोई एपीआई, लीप सेकंड की अनुमति दे सकता है. इससे मिलते-जुलते टाइप google.type.Date और google.protobuf.Timestamp हैं.

फ़ील्ड
hours	int32 24 घंटे के फ़ॉर्मैट में, दिन के घंटे. यह वैल्यू 0 से ज़्यादा या उसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 23 से कम या उसके बराबर होनी चाहिए. कारोबार के बंद होने के समय जैसी स्थितियों के लिए, एपीआई "24:00:00" वैल्यू को अनुमति दे सकता है.
minutes	int32 किसी घंटे के मिनट. वैल्यू 0 से ज़्यादा या उसके बराबर और 59 से कम या उसके बराबर होनी चाहिए.
seconds	int32 मिनट के सेकंड. यह वैल्यू 0 से ज़्यादा या उसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 59 से कम या उसके बराबर होनी चाहिए. अगर एपीआई में लीप-सेकंड की अनुमति है, तो वह 60 की वैल्यू को स्वीकार कर सकता है.
nanos	int32 सेकंड के फ़्रैक्शन, नैनोसेकंड में. यह वैल्यू 0 से ज़्यादा या उसके बराबर और 999,999,999 से कम होनी चाहिए.

TimeZone

आईएएनए टाइम ज़ोन डेटाबेस से किसी टाइम ज़ोन को दिखाता है.

फ़ील्ड
id	string आईएएनए टाइम ज़ोन डेटाबेस का टाइम ज़ोन, जैसे कि "America/New_York".
version	string ज़रूरी नहीं. आईएएनए टाइम ज़ोन डेटाबेस का वर्शन नंबर, जैसे कि "2019a".