DatetimeIndex
=============

.. currentmodule:: pandasCore

.. class:: DatetimeIndex

   Immutable ndarray-like of datetime64 data.


Example
-------

.. code-block:: python

   import pandasCore as pd

   # Create DatetimeIndex
   idx = pd.DatetimeIndex([1, 2, 3], name='my_index')
   print(len(idx))  # 3

Attributes
----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Attribute
     - Description
     - Example
   * - :attr:`~DatetimeIndex.day`
     - The day of the datetime
     - 
   * - :attr:`~DatetimeIndex.day_of_week`
     - The day of the week with Monday=0, Sunday=6
     - 
   * - :attr:`~DatetimeIndex.day_of_year`
     - The ordinal day of the year
     - 
   * - :attr:`~DatetimeIndex.dayofweek`
     - The day of the week with Monday=0, Sunday=6
     - 
   * - :attr:`~DatetimeIndex.dayofyear`
     - The ordinal day of the year
     - 
   * - :attr:`~DatetimeIndex.dtype`
     - Return the dtype object of the underlying data
     - 
   * - :attr:`~DatetimeIndex.empty`
     - Indicator whether DatetimeIndex is empty
     - 
   * - :attr:`~DatetimeIndex.freq`
     - Return the frequency object
     - 
   * - :attr:`~DatetimeIndex.has_duplicates`
     - Return if the index has duplicate values
     - 
   * - :attr:`~DatetimeIndex.hour`
     - The hours of the datetime
     - 
   * - :attr:`~DatetimeIndex.is_leap_year`
     - Boolean indicator if the date belongs to a leap year
     - 
   * - :attr:`~DatetimeIndex.is_monotonic_decreasing`
     - Return if the index is monotonic decreasing
     - 
   * - :attr:`~DatetimeIndex.is_monotonic_increasing`
     - Return if the index is monotonic increasing
     - 
   * - :attr:`~DatetimeIndex.is_month_end`
     - Indicator for whether the date is the last day of the month
     - 
   * - :attr:`~DatetimeIndex.is_month_start`
     - Indicator for whether the date is the first day of the month
     - 
   * - :attr:`~DatetimeIndex.is_quarter_end`
     - Indicator for whether the date is the last day of a quarter
     - 
   * - :attr:`~DatetimeIndex.is_quarter_start`
     - Indicator for whether the date is the first day of a quarter
     - 
   * - :attr:`~DatetimeIndex.is_unique`
     - Return if the index has unique values
     - 
   * - :attr:`~DatetimeIndex.is_year_end`
     - Indicator for whether the date is the last day of the year
     - 
   * - :attr:`~DatetimeIndex.is_year_start`
     - Indicator for whether the date is the first day of the year
     - 
   * - :attr:`~DatetimeIndex.microsecond`
     - The microseconds of the datetime
     - 
   * - :attr:`~DatetimeIndex.minute`
     - The minutes of the datetime
     - 
   * - :attr:`~DatetimeIndex.month`
     - The month of the datetime
     - 
   * - :attr:`~DatetimeIndex.name`
     - Return the name of the DatetimeIndex
     - 
   * - :attr:`~DatetimeIndex.nanosecond`
     - The nanoseconds of the datetime
     - 
   * - :attr:`~DatetimeIndex.ndim`
     - Number of dimensions of the underlying data
     - 
   * - :attr:`~DatetimeIndex.nlevels`
     - Number of levels in this index
     - 
   * - :attr:`~DatetimeIndex.quarter`
     - The quarter of the date
     - 
   * - :attr:`~DatetimeIndex.second`
     - The seconds of the datetime
     - 
   * - :attr:`~DatetimeIndex.shape`
     - Return a tuple of the shape of the underlying data
     - 
   * - :attr:`~DatetimeIndex.size`
     - Return the number of elements in the DatetimeIndex
     - 
   * - :attr:`~DatetimeIndex.str`
     - Vectorized string functions for Index.
     - :ref:`View <example-datetimeindex-str-0>`
   * - :attr:`~DatetimeIndex.tz`
     - Return timezone, if any
     - 
   * - :attr:`~DatetimeIndex.weekday`
     - The day of the week with Monday=0, Sunday=6
     - 
   * - :attr:`~DatetimeIndex.year`
     - The year of the datetime
     - 

Construction
------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.__init__` ``(*args, **kwargs) | () | (data: object = None, freq: object = None, tz: object = None, normalize: object = None, closed: object = None, ambiguous: str = 'raise', dayfirst: bool = False, yearfirst: bool = False, dtype: object = None, copy: bool = False, name: object = None)``
     - Create an empty DatetimeIndex
     - :ref:`View <example-datetimeindex-dunder-initdunder--1>`

Indexing / Selection
--------------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.__getitem__` ``(arg0: object)``
     - 
     - 
   * - :meth:`~DatetimeIndex.take` ``(indices: collections.abc.Sequence[typing.SupportsInt], axis: typing.SupportsInt = 0, allow_fill: bool = True, fill_value: object = None)``
     - Return a new DatetimeIndex of the values selected by the indices.
     - 
   * - :meth:`~DatetimeIndex.where` ``(cond: collections.abc.Sequence[bool], other: object = None)``
     - Replace values where the condition is False.
     - 

Data Manipulation
-----------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.drop` ``(labels: collections.abc.Sequence[typing.SupportsInt], errors: str = 'raise')``
     - Make new DatetimeIndex with passed list of labels deleted.
     - 
   * - :meth:`~DatetimeIndex.droplevel` ``(level: typing.SupportsInt = 0)``
     - Return index with requested level(s) removed.
     - 
   * - :meth:`~DatetimeIndex.insert` ``(loc: typing.SupportsInt, item: typing.SupportsInt)``
     - Insert new item at specified position
     - 
   * - :meth:`~DatetimeIndex.reindex` ``(target: pandasCore.DatetimeIndex, method: object = None, level: object = None, limit: object = None, tolerance: object = None)``
     - Conform DatetimeIndex to new index.
     - 
   * - :meth:`~DatetimeIndex.rename` ``(name: object, *, inplace: bool = False)``
     - Alter DatetimeIndex name.
     - 
   * - :meth:`~DatetimeIndex.set_names` ``(names: object, *, level: object = None, inplace: bool = False)``
     - Set DatetimeIndex name.
     - 

Missing Data
------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.dropna` ``(how: str = 'any')``
     - Return DatetimeIndex without NA/NaT values.
     - 
   * - :meth:`~DatetimeIndex.fillna` ``(value: object = None, downcast: object = None)``
     - Fill NA/NaT values with the specified value.
     - 
   * - :meth:`~DatetimeIndex.isna` ``()``
     - Detect missing values (NaT)
     - 
   * - :meth:`~DatetimeIndex.isnull` ``()``
     - Alias for isna
     - 
   * - :meth:`~DatetimeIndex.notna` ``()``
     - Detect existing (non-missing) values
     - 
   * - :meth:`~DatetimeIndex.notnull` ``()``
     - Alias for notna
     - 

Statistics
----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.max` ``(axis: object = None, skipna: bool = True)``
     - Return the maximum value of the Index.
     - 
   * - :meth:`~DatetimeIndex.mean` ``(*, skipna: bool = True, axis: object = 0)``
     - Return the mean value of the Index as nanoseconds.
     - 
   * - :meth:`~DatetimeIndex.min` ``(axis: object = None, skipna: bool = True)``
     - Return the minimum value of the Index.
     - 
   * - :meth:`~DatetimeIndex.nunique` ``(dropna: bool = True)``
     - Return number of unique elements
     - 
   * - :meth:`~DatetimeIndex.std` ``(axis: object = None, dtype: object = None, out: object = None, ddof: typing.SupportsInt = 1, keepdims: bool = False, skipna: bool = True)``
     - Return the standard deviation as nanoseconds.
     - 
   * - :meth:`~DatetimeIndex.value_counts` ``(normalize: bool = False, sort: bool = True, ascending: bool = False, bins: object = None, dropna: bool = True)``
     - Return a Series containing counts of unique values.
     - 

Aggregation
-----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.groupby` ``(values: collections.abc.Sequence[typing.SupportsInt])``
     - Group the index labels by a mapping
     - 
   * - :meth:`~DatetimeIndex.map` ``(mapper: collections.abc.Callable, na_action: object = None)``
     - Map values using an input mapping or function.
     - 

Comparison
----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.__eq__` ``(self, value, /)``
     - Return self==value.
     - 
   * - :meth:`~DatetimeIndex.__ge__` ``(self, value, /)``
     - Return self>=value.
     - 
   * - :meth:`~DatetimeIndex.__gt__` ``(self, value, /)``
     - Return self>value.
     - 
   * - :meth:`~DatetimeIndex.__le__` ``(self, value, /)``
     - Return self<=value.
     - 
   * - :meth:`~DatetimeIndex.__lt__` ``(self, value, /)``
     - Return self<value.
     - 
   * - :meth:`~DatetimeIndex.__ne__` ``(self, value, /)``
     - Return self!=value.
     - 
   * - :meth:`~DatetimeIndex.equals` ``(other: pandasCore.DatetimeIndex)``
     - Determine if two DatetimeIndex objects are equal
     - 

Sorting
-------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.argsort` ``(*, ascending: bool = True, kind: str = 'quicksort', na_position: str = 'last')``
     - Return the indices that would sort the index.
     - 
   * - :meth:`~DatetimeIndex.searchsorted` ``(value: typing.SupportsInt, side: str = 'left', sorter: object = None)``
     - Find indices where elements should be inserted to maintain order.
     - 
   * - :meth:`~DatetimeIndex.sort_values` ``(*, return_indexer: bool = False, ascending: bool = True, na_position: str = 'last', key: object = None)``
     - Return a sorted copy of the index.
     - 

Reshaping
---------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.to_frame` ``(index: bool = True, name: object = None)``
     - Create a DataFrame with a column containing the Index.
     - 
   * - :meth:`~DatetimeIndex.transpose` ``()``
     - Return the transpose (identity for 1D)
     - 

Combining
---------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.append` ``(other: pandasCore.DatetimeIndex)``
     - Append another DatetimeIndex to this one
     - 
   * - :meth:`~DatetimeIndex.join` ``(other: pandasCore.DatetimeIndex, *, how: str = 'left', level: object = None, return_indexers: bool = False, sort: bool = False)``
     - Compute join of this index with other.
     - 

Time Series
-----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.asof` ``(label: typing.SupportsInt)``
     - Return the label from the index, or NaT
     - 
   * - :meth:`~DatetimeIndex.diff` ``(periods: typing.SupportsInt = 1)``
     - Compute differences between consecutive elements
     - 
   * - :meth:`~DatetimeIndex.shift` ``(periods: typing.SupportsInt = 1, freq: object = None)``
     - Shift index by desired number of periods.
     - 
   * - :meth:`~DatetimeIndex.to_period` ``(*args, **kwargs)``
     - Cast to PeriodArray/PeriodIndex at a particular frequency.
     - 
   * - :meth:`~DatetimeIndex.tz_convert` ``(tz: object)``
     - Convert tz-aware DatetimeIndex from one timezone to another.
     - 
   * - :meth:`~DatetimeIndex.tz_localize` ``(tz: object, ambiguous: str = 'raise', nonexistent: str = 'raise')``
     - Localize tz-naive DatetimeIndex to tz-aware DatetimeIndex.
     - 

I/O
---

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.to_flat_index` ``()``
     - Identity method; returns a copy
     - 
   * - :meth:`~DatetimeIndex.to_julian_date` ``()``
     - Convert DatetimeIndex to Julian Date.
     - 
   * - :meth:`~DatetimeIndex.to_list` ``()``
     - Return a list of the DatetimeIndex values as nanoseconds
     - 
   * - :meth:`~DatetimeIndex.to_numpy` ``(dtype: object = None, copy: bool = False, na_value: object = None)``
     - Convert to a NumPy array.
     - 
   * - :meth:`~DatetimeIndex.to_pydatetime` ``(*args, **kwargs)``
     - Return DatetimeIndex as object ndarray of datetime.datetime objects.
     - 
   * - :meth:`~DatetimeIndex.to_series` ``(index: object = None, name: object = None)``
     - Create a Series with the Index values.
     - 
   * - :meth:`~DatetimeIndex.tolist` ``()``
     - Return a list of the DatetimeIndex values as nanoseconds
     - 

Conversion
----------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.astype` ``(dtype: str, copy: bool = True)``
     - Cast to a specified dtype.
     - 
   * - :meth:`~DatetimeIndex.copy` ``(name: object = None, deep: bool = False)``
     - Make a copy of this DatetimeIndex.
     - 
   * - :meth:`~DatetimeIndex.infer_objects` ``(copy: bool = True)``
     - Attempt to infer better dtype for object columns.
     - 
   * - :meth:`~DatetimeIndex.view` ``(cls: object = None)``
     - Return a view on the index values.
     - 

Iteration
---------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.__contains__` ``(arg0: typing.SupportsInt)``
     - 
     - 
   * - :meth:`~DatetimeIndex.__iter__` ``()``
     - 
     - 
   * - :meth:`~DatetimeIndex.__len__` ``()``
     - 
     - 

Set Operations
--------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.difference` ``(other: pandasCore.DatetimeIndex, sort: object = None)``
     - Return a new DatetimeIndex with elements not in other.
     - 
   * - :meth:`~DatetimeIndex.drop_duplicates` ``(*, keep: str = 'first')``
     - Return DatetimeIndex with duplicate values removed.
     - 
   * - :meth:`~DatetimeIndex.duplicated` ``(keep: str = 'first')``
     - Indicate duplicate index values
     - 
   * - :meth:`~DatetimeIndex.intersection` ``(other: pandasCore.DatetimeIndex, sort: bool = False)``
     - Form the intersection of two DatetimeIndex objects.
     - 
   * - :meth:`~DatetimeIndex.isin` ``(values: collections.abc.Sequence[typing.SupportsInt], level: object = None)``
     - Check if values are in the DatetimeIndex.
     - 
   * - :meth:`~DatetimeIndex.symmetric_difference` ``(other: pandasCore.DatetimeIndex, result_name: object = None, sort: object = None)``
     - Compute the symmetric difference of two Index objects.
     - 
   * - :meth:`~DatetimeIndex.union` ``(other: pandasCore.DatetimeIndex, sort: object = None)``
     - Form the union of two DatetimeIndex objects.
     - 
   * - :meth:`~DatetimeIndex.unique` ``(level: object = None)``
     - Return unique values in the index.
     - 

Datetime Methods
----------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.ceil` ``(freq: str, ambiguous: str = 'raise', nonexistent: str = 'raise')``
     - Perform ceil operation on the data to the specified freq.
     - 
   * - :meth:`~DatetimeIndex.floor` ``(freq: str, ambiguous: str = 'raise', nonexistent: str = 'raise')``
     - Perform floor operation on the data to the specified freq.
     - 
   * - :meth:`~DatetimeIndex.normalize` ``()``
     - Convert times to midnight.
     - 
   * - :meth:`~DatetimeIndex.round` ``(freq: str, ambiguous: str = 'raise', nonexistent: str = 'raise')``
     - Perform round operation on the data to the specified freq.
     - 
   * - :meth:`~DatetimeIndex.strftime` ``(date_format: str)``
     - Convert to string array using specified date_format.
     - 

Other Methods
-------------

.. list-table::
   :widths: 25 60 15
   :header-rows: 1

   * - Method
     - Description
     - Example
   * - :meth:`~DatetimeIndex.__hash__` ``(self, /)``
     - Return hash(self).
     - 
   * - :meth:`~DatetimeIndex.__repr__` ``()``
     - 
     - 
   * - :meth:`~DatetimeIndex.__str__` ``()``
     - 
     - 
   * - :meth:`~DatetimeIndex.all` ``(*, axis: object = None, skipna: bool = True)``
     - Return whether all elements are truthy (non-NaT).
     - 
   * - :meth:`~DatetimeIndex.any` ``(*, axis: object = None, skipna: bool = True)``
     - Return whether any element is truthy (non-NaT).
     - 
   * - :meth:`~DatetimeIndex.argmax` ``(axis: object = None, skipna: bool = True)``
     - Return int position of the largest value in the Index.
     - 
   * - :meth:`~DatetimeIndex.argmin` ``(axis: object = None, skipna: bool = True)``
     - Return int position of the smallest value in the Index.
     - 
   * - :meth:`~DatetimeIndex.as_unit` ``(unit: str, round_ok: bool = True)``
     - Convert to a new unit resolution.
     - 
   * - :meth:`~DatetimeIndex.asof_locs` ``(where: pandasCore.DatetimeIndex, mask: collections.abc.Sequence[bool] | None = None)``
     - Return the locations (indices) for asof queries.
     - 
   * - :meth:`~DatetimeIndex.day_name` ``(locale: object = None)``
     - Return the day names of the DatetimeIndex with specified locale.
     - 
   * - :meth:`~DatetimeIndex.delete` ``(loc: typing.SupportsInt)``
     - Make new DatetimeIndex with element at position deleted
     - 
   * - :meth:`~DatetimeIndex.factorize` ``(sort: bool = False, use_na_sentinel: bool = True)``
     - Encode the object as an enumerated type or categorical variable.
     - 
   * - :meth:`~DatetimeIndex.format` ``(name: bool = False, formatter: object = None, na_rep: str = 'NaT', date_format: object = None)``
     - Render a string representation of the Index.
     - 
   * - :meth:`~DatetimeIndex.get_indexer` ``(target: pandasCore.DatetimeIndex, method: object = None, limit: object = None, tolerance: object = None)``
     - Compute indexer and mask for new index given the current index.
     - 
   * - :meth:`~DatetimeIndex.get_indexer_for` ``(target: collections.abc.Sequence[typing.SupportsInt])``
     - Get indexer for target values
     - 
   * - :meth:`~DatetimeIndex.get_indexer_non_unique` ``(target: pandasCore.DatetimeIndex)``
     - Get indexer and missing indices for non-unique target
     - 
   * - :meth:`~DatetimeIndex.get_level_values` ``(level: typing.SupportsInt)``
     - Return an Index of values for requested level
     - 
   * - :meth:`~DatetimeIndex.get_loc` ``(key: typing.SupportsInt)``
     - Get integer location for requested label
     - 
   * - :meth:`~DatetimeIndex.get_slice_bound` ``(label: typing.SupportsInt, side: str)``
     - Get slice bound
     - 
   * - :meth:`~DatetimeIndex.holds_integer` ``()``
     - Return if the index holds integer values
     - 
   * - :meth:`~DatetimeIndex.identical` ``(other: pandasCore.DatetimeIndex)``
     - Determine if two DatetimeIndex objects are identical
     - 
   * - :meth:`~DatetimeIndex.indexer_at_time` ``(time: str, asof: bool = False)``
     - Return index locations of values at particular time of day.
     - 
   * - :meth:`~DatetimeIndex.indexer_between_time` ``(start_time: str, end_time: str, include_start: bool = True, include_end: bool = True)``
     - Return index locations of values between particular times of day.
     - 
   * - :meth:`~DatetimeIndex.isocalendar` ``()``
     - Return a DataFrame containing ISO year, week number, and weekday.
     - 
   * - :meth:`~DatetimeIndex.item` ``()``
     - Return the first element of the data as a scalar
     - 
   * - :meth:`~DatetimeIndex.memory_usage` ``(deep: bool = False)``
     - Memory usage of the Index values
     - 
   * - :meth:`~DatetimeIndex.month_name` ``(locale: object = None)``
     - Return the month names of the DatetimeIndex with specified locale.
     - 
   * - :meth:`~DatetimeIndex.putmask` ``(mask: collections.abc.Sequence[bool], value: typing.SupportsInt)``
     - Return a new DatetimeIndex with values put where mask is True.
     - 
   * - :meth:`~DatetimeIndex.ravel` ``(order: str = 'C')``
     - Return a flattened array of the index values.
     - 
   * - :meth:`~DatetimeIndex.repeat` ``(repeats: typing.SupportsInt, axis: object = None)``
     - Repeat elements of a DatetimeIndex.
     - 
   * - :meth:`~DatetimeIndex.slice_indexer` ``(start: object = None, end: object = None, step: object = None)``
     - Compute slice locations for input labels.
     - 
   * - :meth:`~DatetimeIndex.slice_locs` ``(start: object = None, end: object = None, step: object = None)``
     - Compute slice locations for input labels.
     - 
   * - :meth:`~DatetimeIndex.snap` ``(freq: str = 'S')``
     - Snap time stamps to nearest occurring frequency.
     - 
   * - :meth:`~DatetimeIndex.sort` ``(ascending: bool = True)``
     - Return a sorted copy of the index.
     - 
   * - :meth:`~DatetimeIndex.sortlevel` ``(level: object = None, ascending: bool = True, sort_remaining: object = None, na_position: str = 'first')``
     - Sort Index by level.
     - 


Code Examples
-------------

The following examples are extracted from the test suite.

.. _example-datetimeindex-str-0:

.. dropdown:: str (test_datetimeindex_str.py:72)
   :class-title: example-dropdown

   .. code-block:: python
      :linenos:
      :lineno-start: 62
      :emphasize-lines: 11

      
      def test_datetimeindex_str_call_with_data():
          """Test DatetimeIndex.str(data) call."""
          print("Testing DatetimeIndex.str(data) call...")
      
          # Create a DatetimeIndex
          dti = pandasCore.DatetimeIndex(['2020-01-01', '2020-12-31'])
      
          # Call DatetimeIndex.str with the index as argument
          try:
              str_accessor = pandasCore.DatetimeIndex.str(dti)
              print(f"  DatetimeIndex.str(dti) returned: {type(str_accessor)}")
              print("  PASSED: DatetimeIndex.str(data) call works")
          except Exception as e:
              # Expected to raise error since DatetimeIndex doesn't contain strings
              print(f"  Error (expected for non-string data): {e}")
              print("  PASSED: Appropriate error raised for non-string Index")
      
      def f_main():
          """Main test function."""
          print("=" * 60)

.. _example-datetimeindex-dunder-initdunder--1:

.. dropdown:: __init__ (test_datetimeindex.py:51)
   :class-title: example-dropdown

   .. code-block:: python
      :linenos:
      :lineno-start: 41
      :emphasize-lines: 11

      TS_2020_01_04 = TS_2020_01_01 + 3 * NS_PER_DAY
      TS_2020_01_05 = TS_2020_01_01 + 4 * NS_PER_DAY
      
      
      def test_constructor_and_properties():
          """Test DatetimeIndex constructor and basic properties"""
          f_print_header("Test: Constructor and Properties")
      
          # Basic construction
          data = [TS_2020_01_01, TS_2020_01_02, TS_2020_01_03]
          dti = pandasCore.DatetimeIndex(data, name="test_dti")
      
          ctx.assert_equal(3, dti.size, "size")
          ctx.assert_equal("test_dti", dti.name, "name")
          ctx.assert_equal("datetime64[ns]", dti.dtype, "dtype")
          ctx.assert_false(dti.empty, "empty")
          ctx.assert_true(dti.is_unique, "is_unique")
          ctx.assert_equal(1, dti.ndim, "ndim")
          ctx.assert_equal((3,), dti.shape, "shape")
          ctx.assert_equal(1, dti.nlevels, "nlevels")