DOC: Update docs

Author: addisonlynch

pandas_datareader/_utils.py

@@ -43,14 +43,13 @@ def _sanitize_dates(start, end):
     if end is None:
         # default to today
         end = dt.date.today()
-    if start > end:
-        raise ValueError("start must be an earlier date than end")
-
     try:
         start = to_datetime(start)
         end = to_datetime(end)
     except (TypeError, ValueError):
         raise ValueError("Invalid date format.")
+    if start > end:
+        raise ValueError("start must be an earlier date than end")
     return start, end
 
 

pandas_datareader/av/time_series.py

@@ -15,7 +15,8 @@ class AVTimeSeriesReader(AlphaVantage):
         Single stock symbol (ticker)
     start : string, int, date, datetime, timestamp
         Starting date. Parses many different kind of date
-        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980')
+        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980'). Defaults to
+        20 years before current date.
     end : string, int, date, datetime, timestamp
         Ending date
     retry_count : int, default 3

pandas_datareader/base.py

@@ -28,11 +28,11 @@ class _BaseReader(object):
     ----------
     symbols : {str, List[str]}
         String symbol of like of symbols
-    start : string, (defaults to 5 years before current date)
-        Starting date, timestamp. Parses many different kind of date
+    start : string, int, date, datetime, timestamp
+        Starting date. Parses many different kind of date
         representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980')
-    end : string, (defaults to today)
-        Ending date, timestamp. Same format as starting date.
+    end : string, int, date, datetime, timestamp
+        Ending date
     retry_count : int, default 3
         Number of times to retry query request.
     pause : float, default 0.1

pandas_datareader/iex/daily.py

@@ -27,11 +27,12 @@ class IEXDailyReader(_DailyBaseReader):
     symbols : string, array-like object (list, tuple, Series), or DataFrame
         Single stock symbol (ticker), array-like object of symbols or
         DataFrame with index containing stock symbols.
-    start : string, (defaults to '1/1/2010')
-        Starting date, timestamp. Parses many different kind of date
-        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980')
-    end : string, (defaults to today)
-        Ending date, timestamp. Same format as starting date.
+    start : string, int, date, datetime, timestamp
+        Starting date. Parses many different kind of date
+        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980'). Defaults to
+        15 years before current date
+    end : string, int, date, datetime, timestamp
+        Ending date
     retry_count : int, default 3
         Number of times to retry query request.
     pause : int, default 0.1
@@ -80,6 +81,11 @@ def __init__(
             chunksize=chunksize,
         )
 
+    @property
+    def default_start_date(self):
+        today = datetime.date.today()
+        return today - datetime.timedelta(days=365 * 15)
+
     @property
     def url(self):
         """API URL"""

pandas_datareader/yahoo/daily.py

@@ -22,11 +22,12 @@ class YahooDailyReader(_DailyBaseReader):
     symbols : string, array-like object (list, tuple, Series), or DataFrame
         Single stock symbol (ticker), array-like object of symbols or
         DataFrame with index containing stock symbols.
-    start : string, (defaults to '1/1/2010')
-        Starting date, timestamp. Parses many different kind of date
-        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980')
-    end : string, (defaults to today)
-        Ending date, timestamp. Same format as starting date.
+    start : string, int, date, datetime, timestamp
+        Starting date. Parses many different kind of date
+        representations (e.g., 'JAN-01-2010', '1/1/10', 'Jan, 1, 1980'). Defaults to
+        15 years before current date.
+    end : string, int, date, datetime, timestamp
+        Ending date
     retry_count : int, default 3
         Number of times to retry query request.
     pause : int, default 0.1