लोकेल (क्षेत्रीय सेटिंग्स) प्राप्त करना

इस लेख में किसी खास स्प्रेडशीट का लोकेल (क्षेत्रीय सेटिंग्स) प्राप्त करने का तरीका समझाया गया है।

इस्तेमाल होने वाला मेथड

Spreadsheet.getSpreadsheetLocale();

इसके लिए Spreadsheet क्लास में उपलब्ध getSpreadsheetLocale() का इस्तेमाल किया जाता है।

इससे वह लोकेल प्राप्त होता है, जो स्प्रेडशीट में “File” → “Settings” के “Locale” में सेट किया गया है। यह सेटिंग तारीख, संख्या और मुद्रा के डिस्प्ले फ़ॉर्मेट को प्रभावित करती है, और यह स्प्रेडशीट देख रहे यूज़र की डिस्प्ले भाषा से अलग चीज़ है।

रिटर्न वैल्यू एक स्ट्रिंग होती है, जिसमें ja_JP की तरह भाषा कोड और देश/क्षेत्र कोड को _ (अंडरस्कोर) से जोड़ा जाता है (कभी-कभी सिर्फ़ भाषा कोड भी हो सकता है)। लोकेल आइडेंटिफ़ायर की अवधारणा समझने के लिए Unicode का UTS #35 भी उपयोगी है।

चलाते समय स्प्रेडशीट को ऐक्सेस किया जाता है, इसलिए पहली बार चलाने पर ऑथराइज़ेशन की ज़रूरत पड़ सकती है।

सैंपल कोड

/**
 * लक्षित स्प्रेडशीट की ID
 * https://docs.google.com/spreadsheets/d/xxx/edit में xxx वाला हिस्सा
 */
const SPREAD_SHEET_ID = '_______________';

/**
 * स्प्रेडशीट का लोकेल (क्षेत्रीय सेटिंग्स) लौटाता है
 */
const getSheetLocale = () => {
  /** लक्षित स्प्रेडशीट */
  const ss = SpreadsheetApp.openById(SPREAD_SHEET_ID);

  /** लोकेल की जानकारी */
  const locale = ss.getSpreadsheetLocale();

  console.log(locale);
  return locale;
};

इसे चलाने पर, स्प्रेडशीट का लोकेल (क्षेत्रीय सेटिंग्स) लौटाया जाता है।

अगर लोकेल “Japan” पर सेट है, तो "ja_JP" प्राप्त होगा।