From 232520fc6625005ec6cc0d86e7d979ee1adbdb94 Mon Sep 17 00:00:00 2001
From: Janelle <jzoutkamp@live.com>
Date: Sat, 10 Mar 2018 15:23:56 +0100
Subject: [PATCH]  DOC: update documentation for pandas.Series.dt.is_month_last

---
 pandas/core/indexes/datetimes.py | 27 ++++++++++++++++++++++++++-
 1 file changed, 26 insertions(+), 1 deletion(-)

diff --git a/pandas/core/indexes/datetimes.py b/pandas/core/indexes/datetimes.py
index 68fbc809a54a5..ec5542f120bc7 100644
--- a/pandas/core/indexes/datetimes.py
+++ b/pandas/core/indexes/datetimes.py
@@ -1756,7 +1756,32 @@ def freq(self, value):
     is_month_end = _field_accessor(
         'is_month_end',
         'is_month_end',
-        "Logical indicating if last day of month (defined by frequency)")
+        """
+        Return a boolean indicating if the date is the last day of the month.
+
+        Returns
+        -------
+        is_month_end : Series of boolean
+
+        See Also
+        --------
+        is_month_start : Returns a boolean indicating if the date is the first day of the month.
+
+        Examples
+        --------
+        >>> import pandas as pd
+        >>> dates = pd.Series(pd.date_range("2018-02-27", periods = 3))
+        >>> dates
+        0   2018-02-27
+        1   2018-02-28
+        2   2018-03-01
+        dtype: datetime64[ns]
+        >>> dates.dt.is_month_end
+        0    False
+        1    True
+        2    False
+        dtype: bool
+        """)
     is_quarter_start = _field_accessor(
         'is_quarter_start',
         'is_quarter_start',