Package google.type

इंडेक्स

DateTime

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

इस टाइप को कुछ संभावित तरीकों में से किसी एक तरीके से सिविल टाइम दिखाया जा सकता है:

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

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

अगर साल, महीना या दिन 0 है, तो तारीख और समय की जानकारी को उस साल, महीने या दिन की जानकारी नहीं माना जाएगा.

अगर सभी तारीख और समय फ़ील्ड सेट हैं और time_offset का कोई भी केस सेट है, तो इस टाइप का इस्तेमाल किसी फ़िज़िकल समय को दिखाने के लिए भी किया जा सकता है. इसके बजाय, समय बताने के लिए 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 से 99,99,99, 999 के बीच होना चाहिए. यह डिफ़ॉल्ट रूप से 0 पर सेट होता है.
यूनियन फ़ील्ड time_offset. ज़रूरी नहीं. तारीख और समय के यूटीसी ऑफ़सेट या टाइम ज़ोन के बारे में बताता है. आने वाले समय में टाइम ज़ोन के डेटा में बदलाव हो सकता है. इसे ध्यान में रखते हुए उनके बीच सावधानी से चुनें. उदाहरण के लिए, कोई देश अपनी डीएसटी के शुरू/खत्म होने की तारीखों में बदलाव करता है और प्रभावित सीमा में आने वाली तारीख और समय से जुड़ी जानकारी पहले ही स्टोर की जा चुकी है. अगर इसे शामिल नहीं किया जाता है, तो तारीख और समय को स्थानीय समय के हिसाब से माना जाता है. time_offset इनमें से सिर्फ़ एक हो सकती है:
utc_offset

Duration

यूटीसी ऑफ़सेट. -18 घंटे और +18 घंटे के बीच, पूरे सेकंड का होना चाहिए. उदाहरण के लिए, -4:00 का यूटीसी ऑफ़सेट { 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 से 99,99,99,999 के बीच होना चाहिए.

TimeZone

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

फ़ील्ड
id

string

IANA टाइम ज़ोन डेटाबेस का टाइम ज़ोन, जैसे कि "अमेरिका/New_York".
version

string

ज़रूरी नहीं. आईएएनए टाइम ज़ोन डेटाबेस का वर्शन नंबर, जैसे कि "2019a".