[ruby-core:63853] [ruby-trunk - Bug #10049] RDoc bug for time format

From: jared@...
Date: 2014-07-19 04:04:21 UTC
List: ruby-core #63853
Issue #10049 has been updated by Jared Beck.


The cited line of documentation:

    %Y - Year with century (can be negative, 4 digits at least)

was taken from `strftime` (time.c:4395).  Therefore, the phrase "4 digits at least" refers to output.

However, the documentation for `Time.strptime` says, simply:

    %Y :: Year with century

and does **not** specify a number of input digits.  (See `lib/time.rb:420`)

Perhaps the documentation for `Time.strptime` could be elaborated, but I don't think it is incorrect.

----------------------------------------
Bug #10049: RDoc bug for time format
https://bugs.ruby-lang.org/issues/10049#change-47883

* Author: Tsuyoshi Sawada
* Status: Open
* Priority: Normal
* Assignee: 
* Category: 
* Target version: 
* ruby -v: 2.1.1
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN
----------------------------------------
A bug report https://bugs.ruby-lang.org/issues/8941 notes a contradiction between RDoc and Ruby behavior. If tadayoshi funaba is correct and `%Y` should be able to accept digits less than four, then the following RDoc description is a bug, and should be corrected.

    %Y - Year with century (can be negative, 4 digits at least)



-- 
https://bugs.ruby-lang.org/

In This Thread

Prev Next