Add "timezone" as our preferred variant

* Fix all instances in the docs
* Closes #4741

Author: coke

doc/Language/faq.rakudoc

@@ -42,7 +42,7 @@ X<|Reference,v6.d (FAQ)>
 The v6.d Specification was released on
 L<Diwali 2018|https://en.wikipedia.org/wiki/Diwali>,
 which was November 6–7 2018, in a
-convenient time zone. 6.d was enabled by default in the Rakudo compiler
+convenient timezone. 6.d was enabled by default in the Rakudo compiler
 release of 2018.11.
 
 The vast majority of 6.d features were already implemented and available

doc/Type/DateTime.rakudoc

@@ -8,15 +8,15 @@
 
 For handling points in civil time, a C<DateTime> object stores year, month,
 day, hour, minute (all L<C<Int>|/type/Int>), second (potentially fractional) and
-a time zone.
+a timezone.
 
 It provides methods for calculating with date (for the Gregorian calendar) and time.
 
 C<DateTime> methods are immutable; if you are tempted to modify one, create a
 modified copy instead.
 
-Time zones are handled as L<C<Int>|/type/Int>s in B<seconds> offset from UTC,
-not by time zone name.
+Timezones are handled as L<C<Int>|/type/Int>s in B<seconds> offset from UTC,
+not by timezone name.
 
 =begin code
 my $dt = DateTime.new(
@@ -61,7 +61,7 @@ Creates a new C<DateTime> object. One option for creating a new C<DateTime> obje
 is from the components (year, month, day, hour, ...) separately. Another is to
 pass a L<C<Date>|/type/Date> object for the date component, and specify the time
 component-wise. Yet another is to obtain the time from an
-L<C<Instant>|/type/Instant>, and only supply the time zone and formatter. Or
+L<C<Instant>|/type/Instant>, and only supply the timezone and formatter. Or
 instead of an L<C<Instant>|/type/Instant> you can supply a L<C<Numeric>|/type/Numeric> as a Unix timestamp
 (but note that this last method provides no way to disambiguate leap seconds,
 unlike using L<C<Instant>|/type/Instant>).
@@ -74,8 +74,8 @@ ISO 8601 standard, as we allow Unicode digits and mixing of condensed
 and extended time formats.
 
 An invalid input string throws an exception of type
-L<C<X::Temporal::InvalidFormat>|/type/X::Temporal::InvalidFormat>. If you supply a string that includes a time
-zone and supply the C<timezone> named argument, an exception of type
+L<C<X::Temporal::InvalidFormat>|/type/X::Temporal::InvalidFormat>. If you supply a string that includes a
+timezone and supply the C<timezone> named argument, an exception of type
 L<C<X::DateTime::TimezoneClash>|/type/X::DateTime::TimezoneClash> is thrown.
 
     my $datetime = DateTime.new(year => 2015,
@@ -91,7 +91,7 @@ L<C<X::DateTime::TimezoneClash>|/type/X::DateTime::TimezoneClash> is thrown.
                              second => 1,
                              timezone => 1);
     $datetime = DateTime.new(2015, 1, 1, # First January of 2015
-                             1, 1, 1);   # Hour, minute, second with default time zone
+                             1, 1, 1);   # Hour, minute, second with default timezone
     $datetime = DateTime.new(now);                       # Instant.
     # from a Unix timestamp
     say $datetime = DateTime.new(1470853583.3);          # OUTPUT: «2016-08-10T18:26:23.300000Z␤»
@@ -185,15 +185,15 @@ Returns the second component, rounded down to an L<C<Int>|/type/Int>.
 
     method timezone(DateTime:D: --> Int:D)
 
-Returns the time zone B<in seconds> as an offset from UTC.
+Returns the timezone B<in seconds> as an offset from UTC.
 
     say DateTime.new('2015-12-24T12:23:00+0200').timezone;          # OUTPUT: «7200␤»
 
 =head2 method offset
 
     method offset(DateTime:D: --> Int:D)
 
-Returns the time zone B<in seconds> as an offset from UTC. This is an alias for
+Returns the timezone B<in seconds> as an offset from UTC. This is an alias for
 L<method timezone|#method timezone>.
 
     say DateTime.new('2015-12-24T12:23:00+0200').offset;            # OUTPUT: «7200␤»
@@ -202,15 +202,15 @@ L<method timezone|#method timezone>.
 
     method offset-in-minutes(DateTime:D: --> Real:D)
 
-Returns the time zone in minutes as an offset from UTC.
+Returns the timezone in minutes as an offset from UTC.
 
     say DateTime.new('2015-12-24T12:23:00+0200').offset-in-minutes; # OUTPUT: «120␤»
 
 =head2 method offset-in-hours
 
     method offset-in-hours(DateTime:D: --> Real:D)
 
-Returns the time zone in hours as an offset from UTC.
+Returns the timezone in hours as an offset from UTC.
 
 =for code
 say DateTime.new('2015-12-24T12:23:00+0200').offset-in-hours;   # OUTPUT: «2␤»
@@ -323,7 +323,7 @@ Returns the date and time as a POSIX/Unix timestamp (non-leap seconds since the
 1970-01-01T00:00:00Z).
 
 If C<$ignore-timezone> is C<True>, the C<DateTime> object will be treated as if
-the time zone offset is zero.
+the timezone offset is zero.
 
     method posix(Bool:D: $ignore-timezone = False, :$real --> Num:D)
 
@@ -386,7 +386,7 @@ Returns the invocant.
 
     method utc(DateTime:D: --> DateTime:D)
 
-Returns a DateTime object for the same time, but in time zone UTC.
+Returns a DateTime object for the same time, but in timezone UTC.
 
     say DateTime.new('2015-12-24T12:23:00+0200').utc;
     # OUTPUT: «2015-12-24T10:23:00Z␤»
@@ -411,7 +411,7 @@ not respect local time and always occur at the end of the I<UTC> day:
 
     method local(DateTime:D: --> DateTime:D)
 
-Returns a DateTime object for the same time, but in the local time zone
+Returns a DateTime object for the same time, but in the local timezone
 (L«C<$*TZ>|/language/variables#index-entry-%24*TZ»).
 
     my $*TZ = -3600;
@@ -425,7 +425,7 @@ Returns a DateTime object for the same time, but in the local time zone
 Takes a C<DateTime> to subtract from and either a
 L«C<Duration>|/type/Duration» or another C<DateTime> object. Returns a new
 C<DateTime> object or the L<C<Duration>|/type/Duration> between the two dates, respectively. When
-subtracting L<C<Duration>|/type/Duration>, time zone of the original C<DateTime> is preserved
+subtracting L<C<Duration>|/type/Duration>, timezone of the original C<DateTime> is preserved
 in the returned C<DateTime> object.
 
     say raku DateTime.new(:2016year) - DateTime.new(:2015year):;
@@ -439,7 +439,7 @@ in the returned C<DateTime> object.
     multi infix:<+> (Duration:D, DateTime:D --> DateTime:D)
 
 Takes a C<DateTime> and increases it by the given
-L«C<Duration>|/type/Duration», preserving the time zone.
+L«C<Duration>|/type/Duration», preserving the timezone.
 
     say DateTime.new(:2015year) + Duration.new(31536001.0);
     # OUTPUT: «2016-01-01T00:00:00Z␤»

doc/Type/X/DateTime/TimezoneClash.rakudoc

@@ -2,13 +2,13 @@
 
 =TITLE class X::DateTime::TimezoneClash
 
-=SUBTITLE Error due to using both time zone offset and :timezone
+=SUBTITLE Error due to using both timezone offset and :timezone
 
 =for code :skip-test<compile time error>
 class X::DateTime::TimezoneClash does X::Temporal is Exception { }
 
 This exception is thrown when code tries to create a L<C<DateTime>|/type/DateTime> object
-specifying both a time zone offset and the named argument C<:timezone>.
+specifying both a timezone offset and the named argument C<:timezone>.
 
 =for code
 say DateTime.new('2015-12-24T12:23:00+0200');                   # works

doc/Type/independent-routines.rakudoc

@@ -1289,13 +1289,13 @@ say sleep-until $instant.Instant; # OUTPUT: «True␤» (eventually...)
 This could be used as a primitive kind of alarm clock.  For instance, say
 you need to get up at 7am on the 4th of September 2015, but for some reason
 your usual alarm clock is broken and you only have your laptop.  You can
-specify the time to get up (being careful about time zones, since
+specify the time to get up (being careful about timezones, since
 C<DateTime.new> uses UTC by default) as an L<C<Instant>|/type/Instant> and pass this to
 C<sleep-until>, after which you can play an mp3 file to wake you up instead
 of your normal alarm clock.  This scenario looks roughly like this:
 
 =for code
-# DateTime.new uses UTC by default, so get time zone from current time
+# DateTime.new uses UTC by default, so get timezone from current time
 my $timezone = DateTime.now.timezone;
 my $instant = DateTime.new(
     year => 2015,

t/15-word-variants.rakutest

@@ -47,6 +47,7 @@ my %variants = %(
     subdirectories => rx:i/ << sub [\s+|\-] directories /,
     subdirectory => rx:i/ << sub [\s+|\-] directory /,
     substring  => rx:i/ << sub \- string /,
+    timezone   => rx:i/ << time [\s+|\-] zone /,
     titlecase  => rx:i/ << title [\s+|\-] case /,
     uppercase  => rx:i/ << upper [\s+|\-] case /,
     zero-width => rx:i/ << zero \s+ width<!before ' joiner'><!before ' no-break space'> /,