-
-
Notifications
You must be signed in to change notification settings - Fork 18.5k
DOC: update the Period.start_time attribute docstring #20325
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
DOC: update the Period.start_time attribute docstring #20325
Conversation
pandas/_libs/tslibs/period.pyx
Outdated
@@ -1164,6 +1164,36 @@ cdef class _Period(object): | |||
|
|||
@property | |||
def start_time(self): | |||
""" | |||
Return the Timestamp. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Get the Timestamp for the start of the period."
pandas/_libs/tslibs/period.pyx
Outdated
""" | ||
Return the Timestamp. | ||
|
||
This attribute returns the timestamp of the particular |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This can be removed I think.
pandas/_libs/tslibs/period.pyx
Outdated
|
||
See also | ||
-------- | ||
Period.dayofyear |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These can be one line each. Period.dayofyear : Return the day of year.
pandas/_libs/tslibs/period.pyx
Outdated
Period.dayofweek | ||
Return the day of the week. | ||
|
||
Returns |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Move returns above See Also
Codecov Report
@@ Coverage Diff @@
## master #20325 +/- ##
==========================================
- Coverage 91.76% 91.73% -0.03%
==========================================
Files 150 150
Lines 49151 49151
==========================================
- Hits 45102 45090 -12
- Misses 4049 4061 +12
Continue to review full report at Codecov.
|
[ci skip]
Added end_time to the see also. Thanks @hammadmashkoor . |
Checklist for the pandas documentation sprint (ignore this if you are doing
an unrelated PR):
scripts/validate_docstrings.py <your-function-or-method>
git diff upstream/master -u -- "*.py" | flake8 --diff
python doc/make.py --single <your-function-or-method>
Please include the output of the validation script below between the "```" ticks:
If the validation script still gives errors, but you think there is a good reason
to deviate in this case (and there are certainly such cases), please state this
explicitly.