Skip to content
This repository
Browse code

Updated the AS guides with some information on the difference between…

… Date.today and Date.current.
  • Loading branch information...
commit 7112cf5e021d8da7c4e073a4e2d2a4afb10671ec 1 parent 0f8d279
Josh Kalderimis joshk authored jeremy committed
10 railties/guides/source/active_support_core_extensions.textile
Source Rendered
@@ -2791,6 +2791,8 @@ h5. +Date.current+
2791 2791
2792 2792 Active Support defines +Date.current+ to be today in the current time zone. That's like +Date.today+, except that it honors the user time zone, if defined. It also defines +Date.yesterday+ and +Date.tomorrow+, and the instance predicates +past?+, +today?+, and +future?+, all of them relative to +Date.current+.
2793 2793
  2794 +When making Date comparisons using methods which honor the user time zone, make sure to use +Date.current+ and not +Date.today+. There are cases where the user time zone might be in the future compared to the system time zone, which +Date.today+ uses by default. This means +Date.today+ may equal +Date.yesterday+.
  2795 +
2794 2796 h5. Named dates
2795 2797
2796 2798 h6. +prev_year+, +next_year+
@@ -3105,7 +3107,7 @@ h5. Named Datetimes
3105 3107
3106 3108 h6. +DateTime.current+
3107 3109
3108   -Active Support defines +DateTime.current+ to be like +Time.now.to_datetime+, except that it honors the user time zone, if defined. It also defines instance predicates +past?+, and +future?+ relative to +DateTime.current+.
  3110 +Active Support defines +DateTime.current+ to be like +Time.now.to_datetime+, except that it honors the user time zone, if defined. It also defines +DateTime.yesterday+ and +DateTime.tomorrow+, and the instance predicates +past?+, and +future?+ relative to +DateTime.current+.
3109 3111
3110 3112 h5. Other Extensions
3111 3113
@@ -3282,6 +3284,12 @@ t.advance(:seconds => 1)
3282 3284
3283 3285 * If +since+ or +ago+ jump to a time that can't be expressed with +Time+ a +DateTime+ object is returned instead.
3284 3286
  3287 +h5. +Time.current+
  3288 +
  3289 +Active Support defines +Time.current+ to be today in the current time zone. That's like +Time.now+, except that it honors the user time zone, if defined. It also defines +Time.yesterday+ and +Time.tomorrow+, and the instance predicates +past?+, +today?+, and +future?+, all of them relative to +Time.current+.
  3290 +
  3291 +When making Time comparisons using methods which honor the user time zone, make sure to use +Time.current+ and not +Time.now+. There are cases where the user time zone might be in the future compared to the system time zone, which +Time.today+ uses by default. This means +Time.now+ may equal +Time.yesterday+.
  3292 +
3285 3293 h4. Time Constructors
3286 3294
3287 3295 Active Support defines +Time.current+ to be +Time.zone.now+ if there's a user time zone defined, with fallback to +Time.now+:

0 comments on commit 7112cf5

Please sign in to comment.
Something went wrong with that request. Please try again.