txt: ## now.md
  now
  
  Combined from primary sources listed below.
  
  # [In Terms](#___top "go to top of document")[§](#(Terms)_term_now "direct link")
  
  See primary documentation
  [in context](/language/terms#term_now)
  for **term now**.
  
  Returns an [`Instant`](/type/Instant) object representing the current time. It includes [leap seconds](https://en.wikipedia.org/wiki/Leap_second) and as such is a few dozen seconds larger than [time](/language/terms#term_time):
  
  ```raku
  say (now - time).Int; # OUTPUT: «37␤»
  ```
  
  # [In DateTime](#___top "go to top of document")[§](#(DateTime)_method_now "direct link")
  
  See primary documentation
  [in context](/type/DateTime#method_now)
  for **method now**.
  
  ```raku
  method now(:$timezone = $*TZ, :&formatter --> DateTime:D)
  ```
  
  Creates a new `DateTime` object from the current system time. A custom [formatter](/routine/formatter) and [timezone](/routine/timezone) can be provided. The `:$timezone` is the offset **in seconds** from [GMT](https://en.wikipedia.org/wiki/Greenwich_Mean_Time) and defaults to the value of [`$*TZ` variable](/language/variables#index-entry-%24*TZ).
  
  ```raku
  say DateTime.now; # OUTPUT: «2018-01-08T13:05:32.703292-06:00␤»
  ```
  
  Note that one may use the methods shown below chained to the `.now` to easily express current values, e.g.,
  
  ```raku
  say DateTime.now.year; # OUTPUT: «2018␤»
  ```
  