Package google.type

इंडेक्स

DateTime

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

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

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

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

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

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

Duration

यूटीसी ऑफ़सेट. इसकी अवधि पूरे सेकंड होनी चाहिए, जो कि -18 घंटे और +18 घंटे के बीच की होनी चाहिए. उदाहरण के लिए, -4:00 के UTC ऑफ़सेट को { seconds: -14400 } के तौर पर दिखाया जाएगा.
time_zone

TimeZone

टाइम ज़ोन.

LatLng

ऐसा ऑब्जेक्ट जो अक्षांश/देशांतर की जोड़ी को दिखाता है. डिग्री अक्षांश और डिग्री देशांतर को दिखाने के लिए, इसे डबल के जोड़े के तौर पर दिखाया जाता है. जब तक अलग से न बताया गया हो, यह ऑब्जेक्ट WGS84 मानक के मुताबिक होना चाहिए. वैल्यू, नॉर्मलाइज़ की जा सकने वाली रेंज के अंदर होनी चाहिए.

फ़ील्ड
latitude

double

डिग्री में अक्षांश. यह [-90.0, +90.0] की रेंज में होना चाहिए.
longitude

double

डिग्री में देशांतर. यह [-180.0, +180.0] की रेंज में होना चाहिए.

TimeZone

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

फ़ील्ड
id

string

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

string

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