Skip to content

Docstring: pd.to_datetime (issue #9107) #9189

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 4, 2015

Conversation

vfilimonov
Copy link
Contributor

Following the issue "to_datetime returns NaT for old dates with coerce=True".

Do I understand correctly that online documentation is build automatically from docstrings? I.e. are there any other files to change?

Also it would be good to make a link to this section of "Caveats and Gotchas", but I'm not sure if the docstring is a good place to do this.

@shoyer
Copy link
Member

shoyer commented Jan 4, 2015

The online documentation is indeed built automatically from docstrings, but it doesn't exclude code in the examples:
http://pandas.pydata.org/pandas-docs/stable/generated/pandas.to_datetime.html#pandas.to_datetime

So it would nice to add the output to these examples (as well as the missing output for the previous examples in this docstring).


Date that does not meet timestamp limitations:

>>> print pd.to_datetime('1300-01-01', format='%Y-%m-%d')
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would omit print here (repr() is called implicitly in the REPL).

@vfilimonov
Copy link
Contributor Author

@shoyer - OK, corrected

shoyer added a commit that referenced this pull request Jan 4, 2015
@shoyer shoyer merged commit 05f59dd into pandas-dev:master Jan 4, 2015
@shoyer
Copy link
Member

shoyer commented Jan 4, 2015

Thanks!

@vfilimonov vfilimonov deleted the doc_to_datetime branch January 5, 2015 11:09
@jorisvandenbossche jorisvandenbossche added this to the 0.16.0 milestone Jan 5, 2015
@vfilimonov vfilimonov restored the doc_to_datetime branch January 6, 2015 11:17
@vfilimonov vfilimonov deleted the doc_to_datetime branch January 6, 2015 11:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants