Devuelve un DatetimeIndex de frecuencia fija.
- Parámetros
-
- comienzo : str o tipo datetime, opcional
-
A la izquierda para generar fechas.
- fin : str o tipo datetime, opcional
-
Con destino a la derecha para generar fechas.
- periodos : int, opcional
-
Número de periodos a generar.
- frecuencia : str o DateOffset, predeterminado ‘D’
-
Las cadenas de frecuencia pueden tener múltiplos, por ejemplo, ‘5H’. Ver aquí para obtener una lista de alias de frecuencia.
- tz : str o tzinfo, opcional
-
Nombre de la zona horaria para devolver DatetimeIndex localizado, por ejemplo, ‘Asia / Hong_Kong’. De forma predeterminada, el DatetimeIndex resultante es ingenuo de zona horaria.
- normalizar : bool, por defecto Falso
-
Normalice las fechas de inicio / finalización a la medianoche antes de generar el rango de fechas.
- nombre : str, predeterminado Ninguno
-
Nombre del DatetimeIndex resultante.
- cerrado : Ninguno, ‘izquierda’, ‘derecha’, opcional
-
Haga que el intervalo se cierre con respecto a la frecuencia dada a la ‘izquierda’, ‘derecha’ o ambos lados (Ninguno, el valor predeterminado).
- ** kwargs
-
Por compatibilidad. No tiene ningún efecto sobre el resultado.
- Devoluciones
-
- rng : DatetimeIndex
Ver también
DatetimeIndex
-
Un contenedor inmutable para las citas.
timedelta_range
-
Devuelve un TimedeltaIndex de frecuencia fija.
period_range
-
Devuelve un PeriodIndex de frecuencia fija.
interval_range
-
Devuelve un IntervalIndex de frecuencia fija.
Notas
De los cuatro parámetros start
, end
, periods
, y freq
, se deben especificar exactamente tres. Si freq
se omite, el resultado DatetimeIndex
tendrá periods
elementos linealmente espaciados entre start
y end
(cerrado por ambos lados).
Para obtener más información sobre las cadenas de frecuencia, consulte este enlace.
Ejemplos de
Especificando los valores
Los siguientes cuatro ejemplos generan el mismo DatetimeIndex, pero variar la combinación de comienzo, fin y periodos.
Especificar comienzo y fin, con la frecuencia diaria predeterminada.
>>> pd.date_range(start='1/1/2018', end='1/08/2018')
DatetimeIndex(['2018-01-01','2018-01-02','2018-01-03','2018-01-04','2018-01-05','2018-01-06','2018-01-07','2018-01-08'],
dtype='datetime64[ns]', freq='D')
Especificar comienzo y periodos, el número de períodos (días).
>>> pd.date_range(start='1/1/2018', periods=8)
DatetimeIndex(['2018-01-01','2018-01-02','2018-01-03','2018-01-04','2018-01-05','2018-01-06','2018-01-07','2018-01-08'],
dtype='datetime64[ns]', freq='D')
Especificar fin y periodos, el número de períodos (días).
>>> pd.date_range(end='1/1/2018', periods=8)
DatetimeIndex(['2017-12-25','2017-12-26','2017-12-27','2017-12-28','2017-12-29','2017-12-30','2017-12-31','2018-01-01'],
dtype='datetime64[ns]', freq='D')
Especificar comienzo, fin, y periodos; la frecuencia se genera automáticamente (espaciada linealmente).
>>> pd.date_range(start='2018-04-24', end='2018-04-27', periods=3)
DatetimeIndex(['2018-04-24 00:00:00','2018-04-25 12:00:00','2018-04-27 00:00:00'],
dtype='datetime64[ns]', freq=None)
Otros parámetros
Cambiado el frecuencia (frecuencia) a 'M'
(frecuencia de fin de mes).
>>> pd.date_range(start='1/1/2018', periods=5, freq='M')
DatetimeIndex(['2018-01-31','2018-02-28','2018-03-31','2018-04-30','2018-05-31'],
dtype='datetime64[ns]', freq='M')
Se permiten múltiples
>>> pd.date_range(start='1/1/2018', periods=5, freq='3M')
DatetimeIndex(['2018-01-31','2018-04-30','2018-07-31','2018-10-31','2019-01-31'],
dtype='datetime64[ns]', freq='3M')
frecuencia también se puede especificar como un objeto Offset.
>>> pd.date_range(start='1/1/2018', periods=5, freq=pd.offsets.MonthEnd(3))
DatetimeIndex(['2018-01-31','2018-04-30','2018-07-31','2018-10-31','2019-01-31'],
dtype='datetime64[ns]', freq='3M')
Especificar tz para configurar la zona horaria.
>>> pd.date_range(start='1/1/2018', periods=5, tz='Asia/Tokyo')
DatetimeIndex(['2018-01-01 00:00:00+09:00','2018-01-02 00:00:00+09:00','2018-01-03 00:00:00+09:00','2018-01-04 00:00:00+09:00','2018-01-05 00:00:00+09:00'],
dtype='datetime64[ns, Asia/Tokyo]', freq='D')
cerrado controla si incluir comienzo y fin que están en el límite. El valor predeterminado incluye puntos de límite en ambos extremos.
>>> pd.date_range(start='2017-01-01', end='2017-01-04', closed=None)
DatetimeIndex(['2017-01-01','2017-01-02','2017-01-03','2017-01-04'],
dtype='datetime64[ns]', freq='D')
Usar closed='left'
excluir fin si cae en el límite.
>>> pd.date_range(start='2017-01-01', end='2017-01-04', closed='left')
DatetimeIndex(['2017-01-01','2017-01-02','2017-01-03'],
dtype='datetime64[ns]', freq='D')
Usar closed='right'
excluir comienzo si cae en el límite.
>>> pd.date_range(start='2017-01-01', end='2017-01-04', closed='right')
DatetimeIndex(['2017-01-02','2017-01-03','2017-01-04'],
dtype='datetime64[ns]', freq='D')