pandas 0.23 - DatetimeIndex.tz_localize()

pandas.DatetimeIndex.tz_localize




pandas

pandas.DatetimeIndex.tz_localize

DatetimeIndex.tz_localize(tz, ambiguous='raise', errors='raise') [source]

DatzIndex को tz-naive DatetimeIndex पर स्थानीय करें।

यह विधि एक टाइम ज़ोन (tz) भोली डेटाइंडेक्स ऑब्जेक्ट लेता है और इस टाइम ज़ोन को जागरूक करता है। यह समय को दूसरे समय क्षेत्र में नहीं ले जाता है। समय क्षेत्र स्थानीयकरण समय क्षेत्र से अनजान वस्तुओं के लिए समय क्षेत्र से स्विच करने में मदद करता है।

पैरामीटर:

tz : string, pytz.timezone, dateutil.tz.tzfile या कोई नहीं

समय क्षेत्र को टाइमस्टैम्प में बदलने के लिए। पासिंग None स्थानीय समय के संरक्षण के समय क्षेत्र की जानकारी को हटा देगा।

अस्पष्ट : str {'infert', 'NaT', 'raise'} या बूल ऐरे, डिफॉल्ट 'raise'

  • 'अनुमान' क्रम के आधार पर डीएसटी-संक्रमण के घंटों का अनुमान लगाने का प्रयास करेगा
  • bool-ndarray जहां True एक DST समय को दर्शाता है, झूठी गैर-DST समय को दर्शाता है (ध्यान दें कि यह ध्वज केवल अस्पष्ट समय के लिए लागू है)
  • 'NaT' NaT को लौटाएगा जहाँ अस्पष्ट समय होते हैं
  • यदि कोई अस्पष्ट समय है तो 'बढ़ाएँ' एक AmbiguousTimeError को बढ़ाएगा

त्रुटियाँ : {'उठाना', 'ज़बरदस्ती'}, डिफ़ॉल्ट 'उठाना'

  • अगर एक टाइमस्टैम्प नहीं है, तो 'उठाना' एक नॉन-एक्सिस्टेंट टाइम इयर को बढ़ाएगा
    निर्दिष्ट समय क्षेत्र में मान्य (उदाहरण के लिए या DST समय से संक्रमण के कारण)
  • अगर टाइमस्टैम्प को निर्दिष्ट समय क्षेत्र में नहीं बदला जा सकता है तो 'मोटे' NaT लौटा देगा

संस्करण में नया 0.19.0।

यह दिखाता है:

DatetimeIndex

सूचकांक निर्दिष्ट समय क्षेत्र में परिवर्तित हो गया।

जन्म देती है:

त्रुटि प्रकार

अगर DatetimeIndex tz- अवगत है और tz कोई नहीं है।

यह भी देखें

DatetimeIndex.tz_convert
एक समय क्षेत्र से दूसरे में tz- अवगत DatetimeIndex कन्वर्ट।

उदाहरण

>>> tz_naive = pd.date_range('2018-03-01 09:00', periods=3)
>>> tz_naive
DatetimeIndex(['2018-03-01 09:00:00', '2018-03-02 09:00:00',
               '2018-03-03 09:00:00'],
              dtype='datetime64[ns]', freq='D')

US / पूर्वी समय क्षेत्र में DatetimeIndex का स्थानीयकरण करें:

>>> tz_aware = tz_naive.tz_localize(tz='US/Eastern')
>>> tz_aware
DatetimeIndex(['2018-03-01 09:00:00-05:00',
               '2018-03-02 09:00:00-05:00',
               '2018-03-03 09:00:00-05:00'],
              dtype='datetime64[ns, US/Eastern]', freq='D')

tz=None , हम स्थानीय समय (UTC में परिवर्तित नहीं) को रखते हुए समय क्षेत्र की जानकारी निकाल सकते हैं:

>>> tz_aware.tz_localize(None)
DatetimeIndex(['2018-03-01 09:00:00', '2018-03-02 09:00:00',
               '2018-03-03 09:00:00'],
              dtype='datetime64[ns]', freq='D')