numpy.datetime_as_string

numpy.datetime_as_string(arr, unit=None, timezone='naive', casting='same_kind')

Преобразование массива дат и времени в массив строк.

Параметры:

arr : array_like of datetime64 Массив UTC временных меток для форматирования. unit : str Одно из None, ‘auto’, или единица измерения даты и времени. timezone : {‘naive’, ‘UTC’, ‘local’} or tzinfo Информация о часовом поясе, используемая при отображении даты и времени. Если ‘UTC’, завершается Z для обозначения UTC. Если ‘local’, сначала выполняется преобразование в местный часовой пояс, а затем добавляется смещение часового пояса +-####. Если объект tzinfo, то делается так же, как с ‘local’, но используется указанный часовой пояс. casting : {‘no’, ‘equiv’, ‘safe’, ‘same_kind’, ‘unsafe’} Преобразование для разрешения изменения между единицами измерения даты и времени.

Возвращаемые значения:

str_arr : ndarray Массив строк с такой же формой, как у arr.

Примеры

>>> d = np.arange('2002-10-27T04:30', 4*60, 60, dtype='M8[m]')
>>> d
array(['2002-10-27T04:30', '2002-10-27T05:30', '2002-10-27T06:30',
       '2002-10-27T07:30'], dtype='datetime64[m]')

Установка часового пояса на UTC показывает ту же информацию, но с суффиксом Z

>>> np.datetime_as_string(d, timezone='UTC')
array(['2002-10-27T04:30Z', '2002-10-27T05:30Z', '2002-10-27T06:30Z',
       '2002-10-27T07:30Z'], dtype='<U35')

Обратите внимание, что мы выбрали даты и время, которые пересекают границу DST. Передача объекта часового пояса pytz напечатает соответствующее смещение

>>> np.datetime_as_string(d, timezone=pytz.timezone('US/Eastern'))
array(['2002-10-27T00:30-0400', '2002-10-27T01:30-0400',
       '2002-10-27T01:30-0500', '2002-10-27T02:30-0500'], dtype='<U39')

Передача единицы изменит точность

>>> np.datetime_as_string(d, unit='h')
array(['2002-10-27T04', '2002-10-27T05', '2002-10-27T06', '2002-10-27T07'],
      dtype='<U32')
>>> np.datetime_as_string(d, unit='s')
array(['2002-10-27T04:30:00', '2002-10-27T05:30:00', '2002-10-27T06:30:00',
       '2002-10-27T07:30:00'], dtype='<U38')

‘casting’ может быть использован для указания, может ли быть изменена точность

>>> np.datetime_as_string(d, unit='h', casting='safe')
TypeError: Cannot create a datetime string as units 'h' from a NumPy
datetime with units 'm' according to the rule 'safe'