@@ -493,36 +493,51 @@ def read_sql(
493
493
... columns=['int_column', 'date_column'])
494
494
>>> df.to_sql('test_data', conn)
495
495
496
- >>> pd.read_sql('SELECT * FROM test_data', con)
496
+ >>> pd.read_sql('SELECT int_column, date_column FROM test_data', conn)
497
+ int_column date_column
498
+ 0 0 10/11/12
499
+ 1 1 12/11/10
497
500
498
- >>> pd.read_sql('table_name ', 'postgres:///db_name') # doctest:+SKIP
501
+ >>> pd.read_sql('test_data ', 'postgres:///db_name') # doctest:+SKIP
499
502
500
503
Apply dateparsing to columns through the ``parse_dates`` argument
501
504
502
- >>> pd.read_sql('SELECT * FROM test_data',
505
+ >>> pd.read_sql('SELECT int_column, date_column FROM test_data',
503
506
... conn,
504
507
... parse_dates=["date_column"])
508
+ int_column date_column
509
+ 0 0 2012-10-11
510
+ 1 1 2010-12-11
505
511
506
512
The ``parse_dates`` argument calls ``pd.to_datetime`` on the provided columns.
507
513
Custom argument values for applying ``pd.to_datetime`` on a column are specified
508
514
via a dictionary format:
509
515
1. Ignore errors while parsing the values of "date_column"
510
516
511
- >>> pd.read_sql('SELECT * FROM test_data',
517
+ >>> pd.read_sql('SELECT int_column, date_column FROM test_data',
512
518
... conn,
513
- ... parse_dates={"date_column": {"errors": "ignore"})
519
+ ... parse_dates={"date_column": {"errors": "ignore"}})
520
+ int_column date_column
521
+ 0 0 2012-10-11
522
+ 1 1 2010-12-11
514
523
515
524
2. Apply a dayfirst dateparsing order on the values of "date_column"
516
525
517
- >>> pd.read_sql('SELECT * FROM test_data',
526
+ >>> pd.read_sql('SELECT int_column, date_column FROM test_data',
518
527
... conn,
519
- ... parse_dates={"date_column": {"dayfirst": True})
528
+ ... parse_dates={"date_column": {"dayfirst": True}})
529
+ int_column date_column
530
+ 0 0 2012-11-10
531
+ 1 1 2010-11-12
520
532
521
533
3. Apply custom formatting when dateparsing the values of "date_column"
522
534
523
- >>> pd.read_sql('SELECT * FROM test_data',
535
+ >>> pd.read_sql('SELECT int_column, date_column FROM test_data',
524
536
... conn,
525
- ... parse_dates={"date_column": {"format": "%d/%m/%Y"})
537
+ ... parse_dates={"date_column": {"format": "%d/%m/%y"}})
538
+ int_column date_column
539
+ 0 0 2012-11-10
540
+ 1 1 2010-11-12
526
541
"""
527
542
pandas_sql = pandasSQL_builder (con )
528
543
0 commit comments