Resolution docstring

pandas/_libs/tslibs/timedeltas.pyx

@@ -770,7 +770,60 @@ cdef class _Timedelta(timedelta):
 
     @property
     def resolution(self):
-        """ return a string representing the lowest resolution that we have """
+        """
+        Return a string representing the lowest (i.e. smallest) time resolution.
+
+        Each timedelta has a defined resolution that represents the lowest OR 
+        most granular level of precision. Each level of resolution is 
+        represented by a short string as defined below:
+
+        ============ ============
+        Resolution   Return value
+        ============ ============ 
+        Days         'D'
+        Hours        'H'
+        Minutes      'T'
+        Seconds      'S'
+        Milliseconds 'L' 
+        Microseconds 'U'
+        Nanoseconds  'N'
+        ============ ============
+
+          - Days:         'D'
+          - Hours:        'H'
+          - Minutes:      'T'
+          - Seconds:      'S'
+          - Milliseconds: 'L'
+          - Microseconds: 'U'
+          - Nanoseconds:  'N'
+
+        Returns
+        -------
+        str
+            Time resolution.
+
+        Examples
+        --------
+        **Using string input**
+
+        >>> td = pd.Timedelta('1 days 2 min 3 us 42 ns')
+        >>> td.resolution
+        'N'
+
+        >>> td = pd.Timedelta('1 days 2 min 3 us')
+        >>> td.resolution
+        'U'
+
+        >>> td = pd.Timedelta('2 min 3 s')
+        >>> td.resolution
+        'S'
+
+        **Using integer input**
+
+        >>> td = pd.Timedelta(36, unit='us')
+        >>> td.resolution
+        'U'
+        """ 
 
         self._ensure_components()
         if self._ns: