तारीख और नंबर के फ़ॉर्मैट

इस दस्तावेज़ में, तारीख और नंबर के फ़ॉर्मैट के नए पैटर्न तय करने का तरीका बताया गया है. इन्हें अपने एपीआई अनुरोध में शामिल किया जा सकता है.

तारीख-समय और नंबर के फ़ॉर्मैट की मदद से यह कंट्रोल किया जा सकता है कि शीट में आपका डेटा कैसा दिखे. Google Sheets में, चुनने के लिए कुछ सामान्य फ़ॉर्मैट दिए गए हैं. हालांकि, आपके पास खुद के फ़ॉर्मैट तय करने का विकल्प भी है.

Sheets के यूज़र इंटरफ़ेस (यूआई) में, फ़ॉर्मैट > नंबर मेन्यू का इस्तेमाल करके, सेल में नंबर और तारीख के फ़ॉर्मैट लागू किए जाते हैं. Google Sheets API में, इन फ़ॉर्मैट को सेट करने के लिए, spreadsheets.batchUpdate तरीके का इस्तेमाल किया जाता है. इससे, UpdateCellsRequest या RepeatCellRequest को भेजा जाता है. अनुरोध में, NumberFormat ऑब्जेक्ट को कॉन्फ़िगर करने के लिए, NumberFormatType (जैसे, NUMBER, CURRENCY, PERCENT, DATE या TIME) और वैकल्पिक pattern स्ट्रिंग की जानकारी दें. अगर pattern को शामिल नहीं किया जाता है, तो Sheets, स्प्रेडशीट की locale के आधार पर, तय किए गए type के लिए डिफ़ॉल्ट फ़ॉर्मैट पैटर्न का इस्तेमाल करता है. उदाहरण के लिए, en_US में CURRENCY के लिए $1,000.12.

किसी रेंज के लिए, तारीख और समय या दशमलव का कस्टम फ़ॉर्मैट सेट करना सैंपल से पता चलता है कि Sheets API का इस्तेमाल करके, फ़ॉर्मैट पैटर्न कैसे सेट किया जाता है. ध्यान दें कि फ़ॉर्मैट की असल रेंडरिंग, स्प्रेडशीट के locale पर निर्भर करती है. इस दस्तावेज़ में यह माना गया है कि locale, en_US है. spreadsheets रिसॉर्स पर spreadsheets.get तरीके का इस्तेमाल करके, SpreadsheetProperties ऑब्जेक्ट को पढ़कर, किसी स्प्रेडशीट के locale का पता लगाया जा सकता है.

ज़्यादा सैंपल के लिए, बेसिक फ़ॉर्मैटिंग और शर्त के साथ फ़ॉर्मैटिंग देखें.

तारीख और समय की वैल्यू के बारे में जानकारी

Sheets, ज़्यादातर अन्य स्प्रेडशीट ऐप्लिकेशन की तरह, तारीख और समय की वैल्यू को दशमलव वैल्यू के तौर पर मानता है. इसकी मदद से, फ़ॉर्मूला में अंकगणित का इस्तेमाल किया जा सकता है. इससे, दिन या हफ़्ते बढ़ाए जा सकते हैं, दो तारीखों और समय को जोड़ा या घटाया जा सकता है, और इसी तरह के अन्य काम किए जा सकते हैं.

Sheets, इपॉक डेट के एक फ़ॉर्मैट का इस्तेमाल करता है. आम तौर पर, इसका इस्तेमाल स्प्रेडशीट में किया जाता है. वैल्यू का पूरा नंबर वाला हिस्सा (दशमलव के बाईं ओर), 30 दिसंबर, 1899 के बाद के दिनों की गिनती करता है. दशमलव के बाद वाला हिस्सा (दशमलव के दाईं ओर), समय को एक दिन के हिस्से के तौर पर गिनता है. उदाहरण के लिए, 1 जनवरी, 1900 को दोपहर का समय 2.5, 2 है, क्योंकि यह 30 दिसंबर, 1899 के दो दिन बाद है. साथ ही, यह 0.5 है, क्योंकि दोपहर का समय आधा दिन होता है. 1 फ़रवरी, 1900 को दोपहर 3 बजे का समय 33.625 है.

Sheets, साल 1900 को लीप ईयर के बजाय सामान्य साल के तौर पर सही तरीके से दिखाता है. तारीख और समय के सीरियल नंबर में, टाइम ज़ोन ऑफ़सेट सेव नहीं होता. इसके बजाय, ये स्प्रेडशीट के timeZone पर आधारित होते हैं. इन्हें spreadsheets.get तरीके का इस्तेमाल करके, SpreadsheetProperties ऑब्जेक्ट से पढ़ा जा सकता है.

तारीख और समय के फ़ॉर्मैट के पैटर्न

तारीख-समय के फ़ॉर्मैट का पैटर्न, टोकन सबस्ट्रिंग की एक स्ट्रिंग होती है. Sheets, पार्स किए जाने पर इसे तारीख-समय के एलिमेंट (जैसे, महीना या घंटा) से बदल देता है.

तारीख और समय के फ़ॉर्मैट के टोकन

यहां दी गई टेबल में, टोकन सबस्ट्रिंग के बारे में बताया गया है. इनका इस्तेमाल, तारीख और समय के फ़ॉर्मैट पैटर्न में किया जा सकता है. + वर्ण से पता चलता है कि पिछला वर्ण एक या उससे ज़्यादा बार दिख सकता है और फिर भी पैटर्न से मैच कर सकता है. Sheets, इस टेबल में शामिल नहीं किए गए वर्णों को लिटरल के तौर पर मानता है और उन्हें बिना किसी बदलाव के आउटपुट करता है.

टोकन जानकारी
h दिन का समय. स्ट्रिंग में AM या PM इंडिकेटर मौजूद है या नहीं, इसके आधार पर 12 और 24 घंटे के फ़ॉर्मैट के बीच स्विच करता है.
hh+ पिछले फ़ॉर्मैट की तरह ही, लेकिन 1 से 9 तक की तारीखों के लिए, शुरुआत में 0 के साथ.
m अगर पिछला नॉन-लिटरल टोकन घंटे था या अगला टोकन सेकंड है, तो यह घंटे में मिनट दिखाता है. इसमें शुरुआत में 0 नहीं होता. अगर ऐसा नहीं है, तो यह साल के महीने को एक संख्या के तौर पर दिखाता है. इसमें शुरुआत में 0 नहीं होता.
M साल का महीना, जिसकी शुरुआत में 0 नहीं है. अपने पैटर्न में मिनट के बजाय महीने की जानकारी देने के लिए, इस टोकन का इस्तेमाल करें.
mm m की तरह, लेकिन दोनों मामलों में शुरुआत में 0 के साथ.
MM साल का महीना, जिसमें शुरुआत में 0 हो. अपने पैटर्न में मिनट के बजाय महीने की जानकारी देने के लिए, इस टोकन का इस्तेमाल करें.
mmm महीने का नाम तीन अक्षरों में (उदाहरण के लिए, "Feb").
mmmm महीने का पूरा नाम. mmmmmm+ भी इससे मेल खाता है.
mmmmm महीने का पहला अक्षर (उदाहरण के लिए, जून के लिए "J").
s मिनट में सेकंड की संख्या, जिसमें शुरुआत में 0 नहीं होता.
ss मिनट में सेकंड, जिसमें शुरुआत में 0 हो.
[h+] किसी समयावधि में बीत चुके घंटों की संख्या. अक्षरों की संख्या से, अंकों की कम से कम संख्या का पता चलता है. इससे पहले 0 जुड़ते हैं.
[m+] किसी समयावधि में बीत चुके मिनट की संख्या. अक्षरों की संख्या से, अंकों की कम से कम संख्या का पता चलता है. इससे पहले 0 जुड़ते हैं.
[s+] किसी समयावधि में बीत चुके सेकंड की संख्या. अक्षरों की संख्या, अंकों की कम से कम संख्या को दिखाती है. साथ ही, यह शुरुआत में 0 जोड़ती है.
d महीने का दिन, जिसमें 10 से कम की संख्याओं के लिए, शुरुआत में 0 नहीं होता.
dd महीने का दिन, जिसमें 10 से कम की संख्याओं के लिए शुरुआत में 0 लगाया जाता है.
ddd हफ़्ते का दिन, तीन अक्षरों वाला छोटा नाम (उदाहरण के लिए, "Mon").
dddd+ हफ़्ते का दिन, पूरा नाम.
y साल, दो अंकों में.
yy
yyy साल, चार अंकों में.
yyyy+
a/p यह AM के लिए "a" और PM के लिए "p" दिखाता है. इससे घंटे भी 12 घंटे वाले फ़ॉर्मैट में बदल जाते हैं. अगर टोकन लेटर को कैपिटल लेटर में लिखा गया है, तो आउटपुट भी कैपिटल लेटर में होगा.
am/pm ऊपर दिए गए उदाहरण की तरह ही, लेकिन इसमें "AM" या "PM" दिखता है और यह हमेशा कैपिटल लेटर में होता है.
0 सेकंड के दसवें हिस्से. 00 का इस्तेमाल करके, सटीक समय को दो अंकों तक बढ़ाया जा सकता है. इसके अलावा, 000 का इस्तेमाल करके, सटीक समय को तीन अंकों (मिलीसेकंड) तक बढ़ाया जा सकता है.
\ यह अगले वर्ण को लिटरल वैल्यू के तौर पर मानता है, न कि किसी खास मतलब के तौर पर.
"text" कोटेशन मार्क के अंदर मौजूद टेक्स्ट को लिटरल के तौर पर दिखाता है.

तारीख और समय के फ़ॉर्मैट के उदाहरण

तारीख और समय Tuesday, April 5, 2016, 4:08:53.528 PM के हिसाब से, यहां दी गई टेबल में कुछ उदाहरण पैटर्न और उनसे जुड़ी तारीख-समय की रेंडरिंग दिखाई गई है. टेबल के दूसरे सेक्शन में, बीते हुए समय के फ़ॉर्मैट के उदाहरण दिखाए गए हैं. ये उदाहरण, 3 hours, 13 minutes, 41.255 seconds के बीते हुए समय के लिए हैं:

तारीख और समय के पैटर्न Tuesday, April 5, 2016, 4:08:53.528 PM
h:mm:ss.00 a/p शाम 4:08:53.53 बजे
hh:mm A/P".M." शाम 04:08 बजे
yyyy-mm-dd 2016-04-05
mmmm d \[dddd\] 5 अप्रैल [मंगलवार]
h PM, ddd mmm dd शाम 4 बजे, मंगलवार 5 अप्रैल
dddd, m/d/yy at h:mm मंगलवार, 5/4/16 को शाम 4:08 बजे
बीते हुए समय के पैटर्न 3 hours, 13 minutes, 41.255 seconds
[hh] 03
[mmmm] 0193
[ss] 11621

नंबर फ़ॉर्मैट के पैटर्न

नंबर फ़ॉर्मैट पैटर्न, टोकन सबस्ट्रिंग की एक स्ट्रिंग होती है. पार्स किए जाने पर, Sheets इसे संबंधित नंबर से बदल देता है. नंबर फ़ॉर्मैट के पैटर्न में, सेमीकोलन से अलग किए गए ज़्यादा से ज़्यादा चार सेक्शन हो सकते हैं. ये सेक्शन, पॉज़िटिव नंबर, नेगेटिव नंबर, शून्य, और टेक्स्ट के लिए इस्तेमाल किए जाने वाले अलग-अलग फ़ॉर्मैट तय करते हैं. इनका क्रम इस तरह होता है:

[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]

आपको किसी फ़ॉर्मैट में चारों सेक्शन शामिल करने की ज़रूरत नहीं है. अगर सिर्फ़ एक सेक्शन शामिल किया जाता है, तो Sheets सभी वैल्यू के लिए उसी फ़ॉर्मैट का इस्तेमाल करता है. दो सेक्शन का इस्तेमाल करने पर, पहला फ़ॉर्मैट शून्य और धनात्मक संख्याओं पर लागू होता है. वहीं, दूसरा फ़ॉर्मैट ऋणात्मक संख्याओं पर लागू होता है. तीन सेक्शन का इस्तेमाल करके, धनात्मक, ऋणात्मक, और शून्य संख्याओं के लिए अलग-अलग फ़ॉर्मैट तय किए जाते हैं. उदाहरण के लिए:

[NUMBER FORMAT]
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT]
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]

हालांकि, अगर दो या इससे ज़्यादा सेक्शन हैं और आखिरी सेक्शन टेक्स्ट फ़ॉर्मैट है, तो Sheets उस सेक्शन को टेक्स्ट फ़ॉर्मैट के तौर पर इस्तेमाल करता है. साथ ही, अन्य सेक्शन इस तरह से काम करते हैं जैसे कि एक सेक्शन कम हो. इसलिए, फ़ाइनल टेक्स्ट फ़ॉर्मैट को शामिल करके, इस तरह के फ़ॉर्मैट तय किए जा सकते हैं:

[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT]
[NUMBER FORMAT];[TEXT FORMAT]

किसी फ़ॉर्मैट को सेक्शन में पार्स करने की प्रोसेस, अन्य पार्सिंग से पहले होती है. इसलिए, तारीख या समय के फ़ॉर्मैट को किसी एक सेक्शन के तौर पर शामिल किया जा सकता है. हालांकि, इसकी उपयोगिता सीमित है.

नंबर फ़ॉर्मैट के टोकन

यहां दी गई टेबल में, टोकन सबस्ट्रिंग के बारे में बताया गया है. इनका इस्तेमाल फ़ॉर्मैट सेक्शन में किया जा सकता है, ताकि यह तय किया जा सके कि उस सेक्शन की वैल्यू को कैसे दिखाया जाए.

टोकन जानकारी
0 यह संख्या में किसी अंक को दिखाता है. अगर अंक ऐसा 0 है जिसे खाली जगह के तौर पर इस्तेमाल किया जाता है, तो उसे 0 के तौर पर रेंडर किया जाता है. उदाहरण के लिए, नंबर फ़ॉर्मैट 00.0, नंबर 3 को "03.0" के तौर पर रेंडर करता है.
# यह संख्या में किसी अंक को दिखाता है. अगर अंक की कोई वैल्यू नहीं है, तो उसे रेंडर नहीं किया जाता. उदाहरण के लिए, नंबर फ़ॉर्मैट ##0, नंबर 12 को "12" के तौर पर रेंडर करता है.
? यह संख्या में किसी अंक को दिखाता है. अगर अंक ऐसा 0 है जिसे खाली जगह के तौर पर इस्तेमाल किया जाता है, तो उसे खाली जगह के तौर पर रेंडर किया जाता है. आम तौर पर, इसका इस्तेमाल फ़िक्स्ड-विड्थ वाले फ़ॉन्ट का इस्तेमाल करते समय, कॉलम में दशमलव बिंदु को अलाइन करने के लिए किया जाता है. उदाहरण के लिए, नंबर फ़ॉर्मैट ???.???, नंबर 12.4 को इस तरह रेंडर करता है: " 12.4 ".
. पहला पीरियड, संख्या में दशमलव बिंदु को दिखाता है. इसके बाद के पीरियड, लिटरल के तौर पर रेंडर किए जाते हैं. अगर फ़ॉर्मैट में दशमलव बिंदु शामिल किया जाता है, तो वह हमेशा रेंडर होता है. भले ही, वह पूर्ण संख्या हो. उदाहरण के लिए, #0.#, संख्या 3 को "3." के तौर पर रेंडर करता है.
% यह लिटरल के तौर पर दिखता है. हालांकि, इसकी वजह से मौजूदा संख्याओं को रेंडर करने से पहले, 100 से गुणा किया जाता है, ताकि प्रतिशत को आसानी से पढ़ा जा सके. उदाहरण के लिए, नंबर फ़ॉर्मैट #%, नंबर 0.25 को "25%" के तौर पर रेंडर करता है.
, अगर यह दो अंकों वाले वर्णों (0, # या ?) के बीच दिखता है, तो यह पूरी संख्या को ग्रुपिंग सेपरेटर (हज़ार के हिसाब से ग्रुप बनाना) के साथ रेंडर करता है. अगर यह अंक वाले वर्णों के बाद आता है, तो यह हर कॉमा के हिसाब से अंकों को एक हज़ार से गुणा करता है. उदाहरण के लिए, #0.0,, फ़ॉर्मैट, 12,200,000 संख्या को 12.2 के तौर पर रेंडर करता है.
E- संख्या को साइंटिफ़िक फ़ॉर्मैट में रेंडर करता है. इसमें, E के बाईं ओर मौजूद फ़ॉर्मैट का इस्तेमाल, नॉन-एक्स्पोनेंट हिस्से के लिए किया जाता है. वहीं, E के दाईं ओर मौजूद फ़ॉर्मैट का इस्तेमाल, एक्स्पोनेंट हिस्से के लिए किया जाता है. E+, पॉज़िटिव एक्स्पोनेंट के लिए + का निशान दिखाता है. E- सिर्फ़ नेगेटिव एक्स्पोनेंट के लिए साइन दिखाता है. अगर छोटे अक्षरों का इस्तेमाल किया जाता है, तो आउटपुट e भी छोटे अक्षरों में होता है. उदाहरण के लिए, नंबर फ़ॉर्मैट ##0.00#E+##, नंबर 0.0000001 को "100.00E-9" के तौर पर रेंडर करता है.
E+
e-
e+
/ अगर यह दो अंकों वाले वर्णों (0, # या ?) के बीच दिखता है, तो यह उन अंकों के ग्रुप को फ़्रैक्शनल फ़ॉर्मैट के तौर पर मानता है. उदाहरण के लिए, नंबर फ़ॉर्मैट 0 #/#, नंबर 23.25 को 23 1/4 के तौर पर रेंडर करता है. डिनोमिनेटर, कोई लिटरल इंटीजर भी हो सकता है. ऐसे मामले में, यह उस इंटीजर को डिनोमिनेटर के तौर पर लागू करता है. नंबर फ़ॉर्मैट 0 #/8, नंबर 23.25 को 23 2/8 के तौर पर दिखाता है. अगर अंश 0 हो जाता है, तो फ़्रैक्शन वाला हिस्सा रेंडर नहीं होता. नंबर फ़ॉर्मैट 0 #/3 के साथ नंबर 23.1, सिर्फ़ 23 के तौर पर रेंडर होता है. ऐसा इसलिए होता है, क्योंकि 0.1 को 0/3 पर राउंड किया जाता है. /, साइंटिफ़िक फ़ॉर्मैट या दशमलव बिंदु वाले फ़ॉर्मैट के साथ काम नहीं करता.
* Microsoft Excel के नंबर फ़ॉर्मैट के साथ काम करने के लिए शामिल किया गया है. Sheets इस टोकन को अनदेखा कर देता है.
_ अगले वर्ण को छोड़कर, एक स्पेस रेंडर करता है. इस टोकन का इस्तेमाल करके, उन नंबर फ़ॉर्मैट को अलाइन करें जिनमें नेगेटिव वैल्यू को ब्रैकेट में रखा जाता है.
\ यह अगले वर्ण को लिटरल वैल्यू के तौर पर मानता है, न कि किसी खास मतलब के तौर पर. उदाहरण के लिए, नंबर फ़ॉर्मैट \#0, नंबर 10 को "#10" के तौर पर रेंडर करता है.
"text" कोटेशन मार्क के अंदर मौजूद टेक्स्ट को लिटरल के तौर पर दिखाता है.
@ अगर सेल में टेक्स्ट इनपुट है, तो यह सेल के लिए रॉ टेक्स्ट डालता है. यह किसी अन्य विशेष वर्ण के साथ काम नहीं करता और संख्याओं के लिए नहीं दिखता. संख्याएं सामान्य फ़ॉर्मैट में दिखती हैं.
$ - + ( ) : space Sheets इन वर्णों और मुद्रा के सामान्य प्रतीकों (जैसे कि $, €, £, और ¥) को लिटरल के तौर पर मानता है और उन्हें बिना किसी बदलाव के दिखाता है.

मेटा निर्देश

इसके अलावा, हर फ़ॉर्मैट सेक्शन में मेटा निर्देश हो सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. ये निर्देश [] वर्णों में बंद होते हैं. ये फ़ॉर्मैट से पहले आते हैं और अतिरिक्त निर्देश देते हैं:

निर्देश जानकारी
[condition] यह सेक्शन की डिफ़ॉल्ट पॉज़िटिव, नेगेटिव या शून्य तुलना को किसी अन्य कंडिशनल एक्सप्रेशन से बदल देता है. उदाहरण के लिए, [<100]"Low";[>1000]"High";000, 100 से कम वैल्यू के लिए "कम" शब्द, 1000 से ज़्यादा वैल्यू के लिए "ज़्यादा" शब्द, और इनके बीच की किसी भी वैल्यू के लिए तीन अंकों की संख्या (शुरुआत में 0 के साथ) दिखाता है. सिर्फ़ पहले दो सब-फ़ॉर्मैट पर शर्तें लागू की जा सकती हैं. अगर कोई संख्या एक से ज़्यादा सब-फ़ॉर्मैट से मैच करती है, तो Sheets पहले मैच का इस्तेमाल करता है. अगर कोई तीसरा फ़ॉर्मैट मौजूद है, तो Sheets उसका इस्तेमाल "अन्य सभी" के लिए करता है. अगर कोई नंबर किसी भी फ़ॉर्मैट से मैच नहीं होता है, तो Sheets सेल की पूरी चौड़ाई में "#" वर्ण रेंडर करता है. अगर यह मौजूद है, तो टेक्स्ट के लिए हमेशा चौथे फ़ॉर्मैट का इस्तेमाल किया जाता है.
[Color] or [Color#] इस सब-फ़ॉर्मैट से रेंडर की गई कोई भी वैल्यू, दिए गए टेक्स्ट के रंग के साथ दिखती है. Color के लिए मान्य वैल्यू ये हैं: काला, नीला, स्यान, हरा, मैजेंटा, लाल, सफ़ेद या पीला. Color# में "#" के लिए मान्य वैल्यू, 1 से 56 तक होती हैं. संख्या के फ़ॉर्मैट के रंग, सेल में उपयोगकर्ता के डाले गए रंगों को बदल देते हैं. हालांकि, ये शर्त के साथ फ़ॉर्मैटिंग से सेट किए गए रंगों को नहीं बदलते. इस कलर पैलेट में, हर नंबर के हिसाब से रंगों की सूची दिखती है. ये Microsoft Excel में मौजूद ColorIndex प्रॉपर्टी पर आधारित होते हैं.
[$currency] यह फ़ॉर्मैट, मुद्रा के चिह्न या कोड को लिटरल के तौर पर दिखाता है. उदाहरण के लिए, [$€]#,##0.00 या [$CAD]#,##0.00. अगर आपने हाइफ़न के बाद कोई वैकल्पिक स्थानीय कोड शामिल किया है, जैसे कि [$CAD-1009], तो Sheets उस स्थानीय कोड को अनदेखा कर देता है.

नंबर फ़ॉर्मैट के उदाहरण

यहां दी गई टेबल में, पैटर्न और उनसे जुड़े फ़ॉर्मैट किए गए नंबर की रेंडरिंग के कुछ उदाहरण दिए गए हैं:

नंबर पैटर्न फ़ॉर्मैट की गई वैल्यू
12345.125 ####.# 12345.1
12.34 000.0000 012.3400
12 #.0# 12.0
5.125 # ???/??? 5 1/8
12000 #,### 12,000
1234.56
-1234.56
$#,##0.00;($#,##0.00) $1,234.56
($1,234.56)
1230000 0.0,,"M" 12 लाख
1234500000 0.00e+00 1.23e+09
123114.15115
MyText
###0.000;"TEXT: "_(@_) 123114.151
TEXT: MyText
1234
-1234
0
MyText
[Blue]#,##0;[Red]#,##0;[Green]0.0;[Magenta]_(@_) 1,234
1,234
0.0
MyText
1005
32
527
[>1000]"HIGH";[Color43][<=200]"LOW";0000 ज़्यादा
कम
0527