Package google.type

इंडेक्स

तारीख

यह पूरी या कुछ समय की कैलेंडर तारीख को दिखाता है. जैसे, जन्मदिन. दिन के समय और टाइम ज़ोन की जानकारी, कहीं और दी गई है या यह जानकारी ज़रूरी नहीं है. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य नहीं होनी चाहिए.
  • महीना और दिन, जिसमें साल शून्य होता है. उदाहरण के लिए, सालगिरह.
  • सिर्फ़ साल, जिसमें महीना और दिन शून्य होता है.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य होती है. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.

मिलते-जुलते टाइप:

फ़ील्ड
year

int32

तारीख का साल. यह 1 से 9999 के बीच होना चाहिए. साल के बिना तारीख तय करने के लिए, इसे 0 पर सेट करें.
month

int32

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर आपको महीने और दिन के बिना साल की जानकारी देनी है, तो इसे 0 पर सेट करें.
day

int32

महीने का दिन. यह 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, इसे 0 पर सेट करके सिर्फ़ साल या साल और महीने की जानकारी दी जा सकती है. ऐसे में, दिन की जानकारी देना ज़रूरी नहीं होता.

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

Duration

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

TimeZone

टाइम ज़ोन.

इंटरवल

यह टाइम इंटरवल को दिखाता है. इसे टाइमस्टैंप के तौर पर कोड किया जाता है. इसमें टाइमस्टैंप के शुरू होने का समय (शामिल है) और टाइमस्टैंप के खत्म होने का समय (शामिल नहीं है) होता है.

शुरू होने की तारीख, खत्म होने की तारीख से पहले या उसके बराबर होनी चाहिए. शुरू होने और खत्म होने का समय एक जैसा होने पर, इंटरवल खाली होता है. इसका मतलब है कि यह किसी भी समय से मेल नहीं खाता. शुरू और खत्म होने का समय तय न होने पर, अंतराल किसी भी समय से मेल खाता है.

फ़ील्ड
start_time

Timestamp

ज़रूरी नहीं. समय अंतराल शुरू होने का समय शामिल है.

अगर इस इंटरवल के हिसाब से कोई टाइमस्टैंप दिया गया है, तो वह शुरू होने के समय के बराबर या उसके बाद का होना चाहिए.
end_time

Timestamp

ज़रूरी नहीं. इंटरवल खत्म होने का समय (अलग से उपलब्ध).

अगर यह तय किया गया है, तो इस इंटरवल से मेल खाने वाला टाइमस्टैंप, खत्म होने के समय से पहले का होना चाहिए.

LatLng

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

फ़ील्ड
latitude

double

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

double

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

LocalizedText

किसी भाषा में टेक्स्ट का स्थानीय वर्शन.

फ़ील्ड
text

string

language_code के हिसाब से, स्थानीय भाषा में लिखी गई स्ट्रिंग.
language_code

string

टेक्स्ट का BCP-47 भाषा कोड, जैसे कि "en-US" या "sr-Latn".

ज़्यादा जानकारी के लिए, http://www.unicode.org/reports/tr35/#Unicode_locale_identifier पर जाएं.

TimeZone

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

फ़ील्ड
id

string

IANA टाइम ज़ोन डेटाबेस का टाइम ज़ोन. उदाहरण के लिए, "America/New_York".
version

string

ज़रूरी नहीं. IANA टाइम ज़ोन डेटाबेस का वर्शन नंबर. उदाहरण के लिए, "2019a".