इस दस्तावेज़ में, तारीख और नंबर के फ़ॉर्मैट के नए पैटर्न तय करने का तरीका बताया गया है. इन्हें अपने एपीआई अनुरोध में शामिल किया जा सकता है.
तारीख-समय और नंबर के फ़ॉर्मैट की मदद से यह कंट्रोल किया जा सकता है कि शीट में आपका डेटा कैसा दिखे. Google Sheets में, चुनने के लिए कुछ सामान्य फ़ॉर्मैट दिए गए हैं. हालांकि, आपके पास खुद के फ़ॉर्मैट तय करने का विकल्प भी है.
Sheets के यूज़र इंटरफ़ेस (यूआई) में, फ़ॉर्मैट > संख्या मेन्यू का इस्तेमाल करके, सेल में संख्या और तारीख के फ़ॉर्मैट लागू किए जाते हैं. Google Sheets API में, इन फ़ॉर्मैट को सेट करने के लिए, spreadsheets.batchUpdate मेथड कॉल का इस्तेमाल करके UpdateCellsRequest या RepeatCellRequest भेजा जाता है.
किसी रेंज के लिए, तारीख, समय या दशमलव का कस्टम फ़ॉर्मैट सेट करें के सैंपल में, Sheets API का इस्तेमाल करके फ़ॉर्मैट पैटर्न सेट करने का तरीका बताया गया है. ध्यान दें कि फ़ॉर्मैट की रेंडरिंग, स्प्रेडशीट के locale पर निर्भर करती है.
इस दस्तावेज़ में यह माना गया है कि locale en_US है. spreadsheets रिसोर्स पर spreadsheets.get तरीके का इस्तेमाल करके, SpreadsheetProperties ऑब्जेक्ट को पढ़कर, किसी स्प्रेडशीट के locale का पता लगाया जा सकता है.
ज़्यादा सैंपल देखने के लिए, बेसिक फ़ॉर्मैटिंग और कंडीशनल फ़ॉर्मैटिंग देखें.
तारीख और समय की वैल्यू के बारे में जानकारी
Sheets, ज़्यादातर स्प्रेडशीट ऐप्लिकेशन की तरह, तारीख और समय की वैल्यू को दशमलव वैल्यू के तौर पर मानता है. इससे फ़ॉर्मूला में इन पर अंकगणित की जा सकती है. जैसे, दिनों या हफ़्तों को बढ़ाया जा सकता है, दो तारीखों और समय को जोड़ा या घटाया जा सकता है. इसके अलावा, इस तरह की अन्य कार्रवाइयां भी की जा सकती हैं.
Sheets में epoch date का इस्तेमाल किया जाता है. यह तारीख, स्प्रेडशीट में आम तौर पर इस्तेमाल की जाती है. वैल्यू का पूर्णांक वाला हिस्सा (दशमलव के बाईं ओर) 30 दिसंबर, 1899 के बाद के दिनों की संख्या दिखाता है. दशमलव के बाद वाला हिस्सा, समय को एक दिन के हिस्से के तौर पर दिखाता है. उदाहरण के लिए, 1 जनवरी, 1900 को दोपहर 2.5, 2 है, क्योंकि यह 30 दिसंबर, 1899 के दो दिन बाद है. साथ ही, 0.5 है, क्योंकि दोपहर आधा दिन होता है. 1 फ़रवरी, 1900 को दोपहर 3 बजे 33.625 है.
Sheets, साल 1900 को सामान्य साल मानता है, न कि लीप ईयर.
तारीख और समय के फ़ॉर्मैट के पैटर्न
तारीख और समय के फ़ॉर्मैट का पैटर्न, टोकन सबस्ट्रिंग की एक स्ट्रिंग होती है. पार्स करने पर, इन्हें तारीख और समय के मिलते-जुलते एलिमेंट (जैसे कि महीना या घंटा) से बदल दिया जाता है.
तारीख और समय के फ़ॉर्मैट वाले टोकन
यहां दी गई टेबल में, टोकन सबस्ट्रिंग के बारे में बताया गया है. इनका इस्तेमाल, तारीख और समय के फ़ॉर्मैट पैटर्न में किया जा सकता है. + वर्ण से पता चलता है कि पिछला वर्ण एक या उससे ज़्यादा बार आ सकता है और फिर भी पैटर्न से मेल खा सकता है. इस टेबल में शामिल नहीं किए गए वर्णों को लिटरल माना जाता है. साथ ही, इन्हें बिना किसी बदलाव के आउटपुट किया जाता है.
| टोकन | ब्यौरा |
|---|---|
h |
दिन का समय. यह फ़ंक्शन, स्ट्रिंग में AM या PM इंडिकेटर मौजूद होने के आधार पर, 12 घंटे और 24 घंटे के फ़ॉर्मैट के बीच स्विच करता है. |
hh+ |
यह पिछले फ़ॉर्मैट जैसा ही है, लेकिन इसमें 1 से 9 के लिए शुरुआती 0 शामिल है. |
m |
अगर पिछला नॉन-लिटरल टोकन घंटे या अगला टोकन सेकंड है, तो यह घंटे में मिनट दिखाता है. इसमें शुरू में 0 नहीं होता. अगर ऐसा नहीं है, तो यह साल के महीने को संख्या के तौर पर दिखाता है (शुरुआत में 0 नहीं होता). |
M |
साल का महीना, जिसमें संख्या से पहले शून्य नहीं है. इस टोकन का इस्तेमाल करके, अपने पैटर्न में मिनट के बजाय महीने के बारे में साफ़ तौर पर बताएं. |
mm |
m की तरह, लेकिन दोनों मामलों में शुरू में 0 होता है. |
MM |
साल का महीना, जिसमें संख्या से पहले शून्य होता है. इस टोकन का इस्तेमाल करके, अपने पैटर्न में मिनट के बजाय महीने के बारे में साफ़ तौर पर बताएं. |
mmm |
महीने के नाम का तीन अक्षरों वाला संक्षिप्त नाम (उदाहरण के लिए, "फ़र॰"). |
mmmm |
महीने का पूरा नाम. mmmmmm+ भी इससे मेल खाता है. |
mmmmm |
महीने का पहला अक्षर (उदाहरण के लिए, जून के लिए "J"). |
s |
मिनट में सेकंड, जिसकी शुरुआत 0 से नहीं होती. |
ss |
मिनट में सेकंड, जिसमें शुरू में 0 होता है. |
[h+] |
समय अवधि में बीते हुए घंटों की संख्या. अक्षरों की संख्या इससे अंकों की कम से कम संख्या का पता चलता है (शुरुआत में 0 जोड़ता है). |
[m+] |
किसी समयावधि में बीते हुए मिनटों की संख्या. अक्षरों की संख्या इससे अंकों की कम से कम संख्या का पता चलता है (शुरुआत में 0 जोड़ता है). |
[s+] |
समय की अवधि में बीते हुए सेकंड की संख्या. अक्षरों की संख्या इससे अंकों की कम से कम संख्या का पता चलता है (शुरुआत में 0 जोड़ता है). |
d |
महीने का दिन. अगर संख्या 10 से कम है, तो शुरुआत में 0 नहीं होगा. |
dd |
महीने का दिन. 10 से कम संख्या के लिए, शुरुआत में 0 लगाया जाता है. |
ddd |
हफ़्ते का दिन, तीन अक्षरों वाला संक्षिप्त नाम (उदाहरण के लिए, "सोम"). |
dddd+ |
हफ़्ते के दिन का पूरा नाम. |
y |
साल के दो अंक. |
yy |
|
yyy |
साल, चार अंकों में. |
yyyy+ |
|
a/p |
सुबह के लिए "a" और दोपहर के लिए "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 p |
hh:mm A/P".M." |
शाम 04:08 बजे |
yyyy-mm-dd |
2016-04-05 |
mmmm d \[dddd\] |
5 अप्रैल [मंगलवार] |
h PM, ddd mmm dd |
शाम 4 बजे, मंगलवार 05 अप्रैल |
dddd, m/d/yy at h:mm |
मंगलवार, 5/4/16 को 16:08 बजे |
| बीते समय के पैटर्न | 3 hours, 13 minutes, 41.255 seconds |
[hh] |
03 |
[mmmm] |
0193 |
[ss] |
11621 |
नंबर फ़ॉर्मैट के पैटर्न
संख्या के फ़ॉर्मैट का पैटर्न, टोकन सबस्ट्रिंग की एक स्ट्रिंग होती है. पार्स करने पर, इन्हें संख्या के मिलते-जुलते फ़ॉर्मैट से बदल दिया जाता है. नंबर फ़ॉर्मैट के पैटर्न में ज़्यादा से ज़्यादा चार सेक्शन हो सकते हैं. इन्हें सेमीकोलन से अलग किया जाता है. ये सेक्शन, पॉज़िटिव नंबर, नेगेटिव नंबर, शून्य, और टेक्स्ट के लिए इस्तेमाल किए जाने वाले अलग-अलग फ़ॉर्मैट तय करते हैं. इनका क्रम इस तरह होता है:
[POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT];[TEXT FORMAT]
आपको किसी फ़ॉर्मैट में चारों सेक्शन शामिल करने की ज़रूरत नहीं है. सिर्फ़ एक सेक्शन शामिल करने पर, उस फ़ॉर्मैट का इस्तेमाल सभी वैल्यू के लिए किया जाता है. दो सेक्शन का इस्तेमाल करने पर, पहले फ़ॉर्मैट को शून्य और पॉज़िटिव नंबर पर लागू किया जाता है. वहीं, दूसरे फ़ॉर्मैट को नेगेटिव नंबर पर लागू किया जाता है. तीन सेक्शन का इस्तेमाल करके, पॉज़िटिव, नेगेटिव, और शून्य संख्याओं के लिए अलग-अलग फ़ॉर्मैट तय किए जाते हैं. उदाहरण के लिए:
[NUMBER FORMAT] [POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT] [POSITIVE FORMAT];[NEGATIVE FORMAT];[ZERO FORMAT]
हालांकि, अगर दो या इससे ज़्यादा सेक्शन हैं और आखिरी सेक्शन टेक्स्ट फ़ॉर्मैट में है, तो उस सेक्शन को टेक्स्ट फ़ॉर्मैट माना जाता है. साथ ही, अन्य सेक्शन ऐसे काम करते हैं जैसे उनमें एक सेक्शन कम हो. इसलिए, फ़ाइनल टेक्स्ट फ़ॉर्मैट को शामिल करके, इस तरह के फ़ॉर्मैट तय किए जा सकते हैं:
[POSITIVE/ZERO FORMAT];[NEGATIVE FORMAT];[TEXT FORMAT] [NUMBER FORMAT];[TEXT FORMAT]
किसी फ़ॉर्मैट को सेक्शन में पार्स करने की प्रोसेस, अन्य पार्सिंग से पहले होती है. इसलिए, तारीख या समय के फ़ॉर्मैट को सेक्शन के तौर पर शामिल किया जा सकता है. हालांकि, इसका इस्तेमाल सीमित तौर पर किया जा सकता है.
नंबर फ़ॉर्मैट टोकन
यहां दी गई टेबल में, टोकन सबस्ट्रिंग के बारे में बताया गया है. इनका इस्तेमाल फ़ॉर्मैट सेक्शन में किया जा सकता है. इससे यह तय किया जा सकता है कि उस सेक्शन के लिए वैल्यू कैसे दिखाई जाएं.
| टोकन | ब्यौरा |
|---|---|
0 |
यह संख्या में किसी अंक को दिखाता है. अगर अंक ऐसा 0 है जिसे खाली जगह के तौर पर इस्तेमाल किया जाता है, तो
इसे 0 के तौर पर रेंडर किया जाता है. उदाहरण के लिए, संख्या का फ़ॉर्मैट 00.0, संख्या 3 को "03.0" के तौर पर रेंडर करता है. |
# |
यह संख्या में किसी अंक को दिखाता है. अगर अंक ऐसा 0 है जिसकी कोई वैल्यू नहीं है, तो
इसे रेंडर नहीं किया जाता. उदाहरण के लिए, संख्या का फ़ॉर्मैट ##0
संख्या 12 को "12" के तौर पर रेंडर करता है. |
? |
यह संख्या में किसी अंक को दिखाता है. अगर अंक ऐसा 0 है जिसे खाली जगह के तौर पर इस्तेमाल किया जाता है, तो उसे खाली जगह के तौर पर रेंडर किया जाता है. इसका इस्तेमाल अक्सर फ़िक्स्ड विड्थ वाले फ़ॉन्ट का इस्तेमाल करते समय, किसी कॉलम में दशमलव बिंदु को अलाइन करने के लिए किया जाता है. उदाहरण के लिए, नंबर का फ़ॉर्मैट
???.???, संख्या 12.4 को इस तरह रेंडर करता है:
" 12.4 ". |
. |
पहला पीरियड, संख्या में दशमलव बिंदु को दिखाता है. इसके बाद के समय को लिटरल के तौर पर रेंडर किया जाता है. अगर आपने फ़ॉर्मैट में दशमलव बिंदु शामिल किया है, तो इसे हमेशा रेंडर किया जाता है. भले ही, संख्याएं पूर्णांक हों. उदाहरण के लिए,
#0.#, संख्या 3 को "3." के तौर पर रेंडर करता है. |
% |
यह लिटरल के तौर पर दिखता है. हालांकि, इससे मौजूदा संख्याओं में 100 से गुणा हो जाता है. इसके बाद, उन्हें रेंडर किया जाता है, ताकि प्रतिशत को ज़्यादा आसानी से पढ़ा जा सके. उदाहरण के लिए, नंबर फ़ॉर्मैट #%
से, संख्या 0.25 को "25%" के तौर पर रेंडर किया जाता है. |
, |
अगर यह दो अंकों वाले वर्णों (0,
# या ?) के बीच दिखता है, तो यह पूरे नंबर को
ग्रुपिंग सेपरेटर (हज़ार के हिसाब से ग्रुपिंग) के साथ रेंडर करता है. अगर इसमें अंकों के बाद कॉमा का इस्तेमाल किया जाता है, तो हर कॉमा के हिसाब से अंकों को एक हज़ार गुना बढ़ा दिया जाता है. उदाहरण के लिए, #0.0,, फ़ॉर्मैट में मौजूद संख्या 1,22,00,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 हो जाता है, तो फ़्रैक्शन वाला हिस्सा रेंडर नहीं होता. संख्या 23.1 को 0 #/3 फ़ॉर्मैट में दिखाने पर, यह सिर्फ़ 23 के तौर पर दिखेगी. इसकी वजह यह है कि 0.1 को 0/3 में बदल दिया गया है. /, साइंटिफ़िक फ़ॉर्मैट या ऐसे फ़ॉर्मैट के साथ काम नहीं करता जिसमें दशमलव बिंदु मौजूद हो. |
* |
इसे Microsoft Excel के नंबर फ़ॉर्मैट के साथ काम करने के लिए शामिल किया गया है. इसे अनदेखा कर दिया जाता है. |
_ |
अंडरस्कोर टोकन, अगले वर्ण को स्किप करता है और एक स्पेस रेंडर करता है. इसका इस्तेमाल, नंबर फ़ॉर्मैट को लाइन अप करने के लिए किया जाता है. इसमें नेगेटिव वैल्यू को कोष्ठक में रखा जाता है. |
\ |
अगले वर्ण को लिटरल वैल्यू के तौर पर मानता है. इसका कोई खास मतलब नहीं होता. उदाहरण के लिए, \#0 नंबर फ़ॉर्मैट, 10 को "#10" के तौर पर रेंडर करता है. |
"text" |
कोटेशन मार्क के अंदर मौजूद टेक्स्ट को लिटरल के तौर पर दिखाता है. |
@ |
अगर सेल में टेक्स्ट डाला गया है, तो यह सेल के लिए रॉ टेक्स्ट डालता है. यह किसी भी अन्य खास वर्ण के साथ काम नहीं करता. साथ ही, यह संख्यात्मक वैल्यू के लिए नहीं दिखता. संख्यात्मक वैल्यू, सामान्य फ़ॉर्मैट में दिखती हैं. |
$ - + ( ) : space |
Sheets इन वर्णों को लिटरल के तौर पर मानता है और इन्हें बिना किसी बदलाव के दिखाता है. |
मेटा निर्देश
इसके अलावा, फ़ॉर्मैट के हर सेक्शन में मेटा निर्देश शामिल किए जा सकते हैं. हालांकि, ऐसा करना ज़रूरी नहीं है. ये निर्देश, [] वर्णों में शामिल होते हैं. ये निर्देश, फ़ॉर्मैट से पहले आते हैं और अतिरिक्त निर्देश देते हैं. मेटा निर्देश दो तरह के होते हैं. किसी सेक्शन में दोनों का इस्तेमाल किया जा सकता है:
| निर्देश | ब्यौरा |
|---|---|
[condition] |
यह फ़ंक्शन, सेक्शन की डिफ़ॉल्ट पॉज़िटिव, नेगेटिव या ज़ीरो तुलना को किसी अन्य शर्त वाले एक्सप्रेशन से बदलता है. उदाहरण के लिए,
[<100]"Low";[>1000]"High";000, 100 से कम वैल्यू के लिए "Low", 1,000 से ज़्यादा वैल्यू के लिए "High", और इन दोनों के बीच की वैल्यू के लिए तीन अंकों की संख्या (शुरुआत में 0 के साथ) रेंडर करता है. शर्तें सिर्फ़ पहले दो सब-फ़ॉर्मैट पर लागू की जा सकती हैं. अगर कोई संख्या एक से ज़्यादा सब-फ़ॉर्मैट से मेल खाती है, तो वह उस सब-फ़ॉर्मैट का इस्तेमाल करती है जिससे वह सबसे पहले मेल खाती है. अगर कोई तीसरा फ़ॉर्मैट है, तो उसका इस्तेमाल "अन्य सभी" के लिए किया जाता है. अगर कोई संख्या इनमें से किसी भी फ़ॉर्मैट से मेल नहीं खाती है, तो उसे सेल की चौड़ाई में मौजूद सभी "#" के तौर पर रेंडर किया जाता है. अगर यह मौजूद है, तो टेक्स्ट के लिए हमेशा चौथे फ़ॉर्मैट का इस्तेमाल किया जाता है. |
[Color] or [Color#] |
इस सब-फ़ॉर्मैट से रेंडर होने वाली कोई भी वैल्यू, दिए गए टेक्स्ट के रंग में दिखती है. Color एट्रिब्यूट के लिए मान्य वैल्यू ये हैं: काला, नीला, स्यान, हरा, मजेंटा, लाल, सफ़ेद या पीला.
Color# में "#" के लिए मान्य वैल्यू 1 से 56 तक होती हैं. संख्या के फ़ॉर्मैट के रंग, सेल में उपयोगकर्ता की ओर से डाले गए किसी भी रंग को बदल देते हैं. हालांकि, ये कंडीशनल फ़ॉर्मैटिंग से सेट किए गए रंगों को नहीं बदलते. इस कलर पैलेट में, हर नंबर के हिसाब से कलर की सूची दिखती है. ये Microsoft Excel में मौजूद ColorIndex प्रॉपर्टी पर आधारित होते हैं. |
नंबर फ़ॉर्मैट के उदाहरण
यहां दी गई टेबल में, पैटर्न के कुछ उदाहरण और उनके हिसाब से फ़ॉर्मैट किए गए नंबर की रेंडरिंग दिखाई गई है:
| नंबर | पैटर्न | फ़ॉर्मैट की गई वैल्यू |
|---|---|---|
| 12345.125 | ####.# |
12345.1 |
| 12.34 | 000.0000 |
012.3400 |
| 12 | #.0# |
12.0 |
| 5.125 | # ???/??? |
5 1/8 |
| 12000 | #,### |
12,000 |
| 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 |
HIGH LOW 0527 |