Modified:
websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/time/CalendarUtils.html
==============================================================================
---
websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/time/CalendarUtils.html
(original)
+++
websites/production/commons/content/proper/commons-lang/apidocs/src-html/org/apache/commons/lang3/time/CalendarUtils.html
Thu Aug 29 19:59:17 2024
@@ -30,141 +30,213 @@
<span class="source-line-no">017</span><span id="line-17"></span>
<span class="source-line-no">018</span><span id="line-18">package
org.apache.commons.lang3.time;</span>
<span class="source-line-no">019</span><span id="line-19"></span>
-<span class="source-line-no">020</span><span id="line-20">import
java.util.Calendar;</span>
-<span class="source-line-no">021</span><span id="line-21">import
java.util.Locale;</span>
-<span class="source-line-no">022</span><span id="line-22">import
java.util.Locale.Category;</span>
-<span class="source-line-no">023</span><span id="line-23">import
java.util.Map;</span>
-<span class="source-line-no">024</span><span id="line-24">import
java.util.Objects;</span>
-<span class="source-line-no">025</span><span id="line-25"></span>
-<span class="source-line-no">026</span><span id="line-26">/**</span>
-<span class="source-line-no">027</span><span id="line-27"> * Helps use {@link
Calendar}s.</span>
-<span class="source-line-no">028</span><span id="line-28"> *</span>
-<span class="source-line-no">029</span><span id="line-29"> * @since 3.10</span>
-<span class="source-line-no">030</span><span id="line-30"> */</span>
-<span class="source-line-no">031</span><span id="line-31">public class
CalendarUtils {</span>
-<span class="source-line-no">032</span><span id="line-32"></span>
-<span class="source-line-no">033</span><span id="line-33"> /**</span>
-<span class="source-line-no">034</span><span id="line-34"> * The singleton
instance for {@link Calendar#getInstance()}. The instance is created when the
class is initialized and is based on the current time in the</span>
-<span class="source-line-no">035</span><span id="line-35"> * default time
zone with the default {@link Category#FORMAT} locale.</span>
-<span class="source-line-no">036</span><span id="line-36"> *</span>
-<span class="source-line-no">037</span><span id="line-37"> * @see
CalendarUtils#getInstance()</span>
-<span class="source-line-no">038</span><span id="line-38"> */</span>
-<span class="source-line-no">039</span><span id="line-39"> public static
final CalendarUtils INSTANCE = getInstance();</span>
-<span class="source-line-no">040</span><span id="line-40"></span>
-<span class="source-line-no">041</span><span id="line-41"> /**</span>
-<span class="source-line-no">042</span><span id="line-42"> * Creates a new
instance based on the current time in the default time zone with the default
{@link Category#FORMAT} locale.</span>
-<span class="source-line-no">043</span><span id="line-43"> *</span>
-<span class="source-line-no">044</span><span id="line-44"> * @return a new
instance.</span>
-<span class="source-line-no">045</span><span id="line-45"> * @since
3.14.0</span>
-<span class="source-line-no">046</span><span id="line-46"> */</span>
-<span class="source-line-no">047</span><span id="line-47"> public static
CalendarUtils getInstance() {</span>
-<span class="source-line-no">048</span><span id="line-48"> return new
CalendarUtils(Calendar.getInstance());</span>
-<span class="source-line-no">049</span><span id="line-49"> }</span>
-<span class="source-line-no">050</span><span id="line-50"></span>
-<span class="source-line-no">051</span><span id="line-51"> /**</span>
-<span class="source-line-no">052</span><span id="line-52"> * Gets a
CalendarUtils using the default time zone and specified locale. The {@code
CalendarUtils} returned is based on the current time in the</span>
-<span class="source-line-no">053</span><span id="line-53"> * default time
zone with the given locale.</span>
-<span class="source-line-no">054</span><span id="line-54"> *</span>
-<span class="source-line-no">055</span><span id="line-55"> * @param locale
the locale for the week data</span>
-<span class="source-line-no">056</span><span id="line-56"> * @return a
Calendar.</span>
-<span class="source-line-no">057</span><span id="line-57"> */</span>
-<span class="source-line-no">058</span><span id="line-58"> static
CalendarUtils getInstance(final Locale locale) {</span>
-<span class="source-line-no">059</span><span id="line-59"> return new
CalendarUtils(Calendar.getInstance(locale), locale);</span>
-<span class="source-line-no">060</span><span id="line-60"> }</span>
-<span class="source-line-no">061</span><span id="line-61"></span>
-<span class="source-line-no">062</span><span id="line-62"> private final
Calendar calendar;</span>
-<span class="source-line-no">063</span><span id="line-63"></span>
-<span class="source-line-no">064</span><span id="line-64"> private final
Locale locale;</span>
+<span class="source-line-no">020</span><span id="line-20">import
java.time.LocalDateTime;</span>
+<span class="source-line-no">021</span><span id="line-21">import
java.time.OffsetDateTime;</span>
+<span class="source-line-no">022</span><span id="line-22">import
java.time.ZoneId;</span>
+<span class="source-line-no">023</span><span id="line-23">import
java.time.ZonedDateTime;</span>
+<span class="source-line-no">024</span><span id="line-24">import
java.util.Calendar;</span>
+<span class="source-line-no">025</span><span id="line-25">import
java.util.Locale;</span>
+<span class="source-line-no">026</span><span id="line-26">import
java.util.Locale.Category;</span>
+<span class="source-line-no">027</span><span id="line-27">import
java.util.Map;</span>
+<span class="source-line-no">028</span><span id="line-28">import
java.util.Objects;</span>
+<span class="source-line-no">029</span><span id="line-29"></span>
+<span class="source-line-no">030</span><span id="line-30">/**</span>
+<span class="source-line-no">031</span><span id="line-31"> * Helps use {@link
Calendar}s.</span>
+<span class="source-line-no">032</span><span id="line-32"> *</span>
+<span class="source-line-no">033</span><span id="line-33"> * @since 3.10</span>
+<span class="source-line-no">034</span><span id="line-34"> */</span>
+<span class="source-line-no">035</span><span id="line-35">public class
CalendarUtils {</span>
+<span class="source-line-no">036</span><span id="line-36"></span>
+<span class="source-line-no">037</span><span id="line-37"> /**</span>
+<span class="source-line-no">038</span><span id="line-38"> * The singleton
instance for {@link Calendar#getInstance()}. The instance is created when the
class is initialized and is based on the current time in the</span>
+<span class="source-line-no">039</span><span id="line-39"> * default time
zone with the default {@link Category#FORMAT} locale.</span>
+<span class="source-line-no">040</span><span id="line-40"> *</span>
+<span class="source-line-no">041</span><span id="line-41"> * @see
CalendarUtils#getInstance()</span>
+<span class="source-line-no">042</span><span id="line-42"> */</span>
+<span class="source-line-no">043</span><span id="line-43"> public static
final CalendarUtils INSTANCE = getInstance();</span>
+<span class="source-line-no">044</span><span id="line-44"></span>
+<span class="source-line-no">045</span><span id="line-45"> /**</span>
+<span class="source-line-no">046</span><span id="line-46"> * Creates a new
instance based on the current time in the default time zone with the default
{@link Category#FORMAT} locale.</span>
+<span class="source-line-no">047</span><span id="line-47"> *</span>
+<span class="source-line-no">048</span><span id="line-48"> * @return a new
instance.</span>
+<span class="source-line-no">049</span><span id="line-49"> * @since
3.14.0</span>
+<span class="source-line-no">050</span><span id="line-50"> */</span>
+<span class="source-line-no">051</span><span id="line-51"> public static
CalendarUtils getInstance() {</span>
+<span class="source-line-no">052</span><span id="line-52"> return new
CalendarUtils(Calendar.getInstance());</span>
+<span class="source-line-no">053</span><span id="line-53"> }</span>
+<span class="source-line-no">054</span><span id="line-54"></span>
+<span class="source-line-no">055</span><span id="line-55"> /**</span>
+<span class="source-line-no">056</span><span id="line-56"> * Gets a
CalendarUtils using the default time zone and specified locale. The {@code
CalendarUtils} returned is based on the current time in the</span>
+<span class="source-line-no">057</span><span id="line-57"> * default time
zone with the given locale.</span>
+<span class="source-line-no">058</span><span id="line-58"> *</span>
+<span class="source-line-no">059</span><span id="line-59"> * @param locale
the locale for the week data</span>
+<span class="source-line-no">060</span><span id="line-60"> * @return a
Calendar.</span>
+<span class="source-line-no">061</span><span id="line-61"> */</span>
+<span class="source-line-no">062</span><span id="line-62"> static
CalendarUtils getInstance(final Locale locale) {</span>
+<span class="source-line-no">063</span><span id="line-63"> return new
CalendarUtils(Calendar.getInstance(locale), locale);</span>
+<span class="source-line-no">064</span><span id="line-64"> }</span>
<span class="source-line-no">065</span><span id="line-65"></span>
<span class="source-line-no">066</span><span id="line-66"> /**</span>
-<span class="source-line-no">067</span><span id="line-67"> * Creates an
instance for the given Calendar.</span>
+<span class="source-line-no">067</span><span id="line-67"> * Converts a
Calendar to a LocalDateTime.</span>
<span class="source-line-no">068</span><span id="line-68"> *</span>
-<span class="source-line-no">069</span><span id="line-69"> * @param
calendar A Calendar.</span>
-<span class="source-line-no">070</span><span id="line-70"> */</span>
-<span class="source-line-no">071</span><span id="line-71"> public
CalendarUtils(final Calendar calendar) {</span>
-<span class="source-line-no">072</span><span id="line-72">
this(calendar, Locale.getDefault());</span>
-<span class="source-line-no">073</span><span id="line-73"> }</span>
-<span class="source-line-no">074</span><span id="line-74"></span>
-<span class="source-line-no">075</span><span id="line-75"> /**</span>
-<span class="source-line-no">076</span><span id="line-76"> * Creates an
instance for the given Calendar.</span>
-<span class="source-line-no">077</span><span id="line-77"> *</span>
-<span class="source-line-no">078</span><span id="line-78"> * @param
calendar A Calendar.</span>
-<span class="source-line-no">079</span><span id="line-79"> * @param locale
A Locale.</span>
-<span class="source-line-no">080</span><span id="line-80"> */</span>
-<span class="source-line-no">081</span><span id="line-81">
CalendarUtils(final Calendar calendar, final Locale locale) {</span>
-<span class="source-line-no">082</span><span id="line-82">
this.calendar = Objects.requireNonNull(calendar, "calendar");</span>
-<span class="source-line-no">083</span><span id="line-83"> this.locale
= Objects.requireNonNull(locale, "locale");</span>
-<span class="source-line-no">084</span><span id="line-84"> }</span>
-<span class="source-line-no">085</span><span id="line-85"> /**</span>
-<span class="source-line-no">086</span><span id="line-86"> * Gets the
current day of month.</span>
-<span class="source-line-no">087</span><span id="line-87"> *</span>
-<span class="source-line-no">088</span><span id="line-88"> * @return the
current day of month.</span>
-<span class="source-line-no">089</span><span id="line-89"> */</span>
-<span class="source-line-no">090</span><span id="line-90"> public int
getDayOfMonth() {</span>
-<span class="source-line-no">091</span><span id="line-91"> return
calendar.get(Calendar.DAY_OF_MONTH);</span>
-<span class="source-line-no">092</span><span id="line-92"> }</span>
-<span class="source-line-no">093</span><span id="line-93"></span>
-<span class="source-line-no">094</span><span id="line-94"> /**</span>
-<span class="source-line-no">095</span><span id="line-95"> * Gets the
current day of year.</span>
-<span class="source-line-no">096</span><span id="line-96"> *</span>
-<span class="source-line-no">097</span><span id="line-97"> * @return the
current day of year.</span>
-<span class="source-line-no">098</span><span id="line-98"> * @since
3.13.0</span>
-<span class="source-line-no">099</span><span id="line-99"> */</span>
-<span class="source-line-no">100</span><span id="line-100"> public int
getDayOfYear() {</span>
-<span class="source-line-no">101</span><span id="line-101"> return
calendar.get(Calendar.DAY_OF_YEAR);</span>
-<span class="source-line-no">102</span><span id="line-102"> }</span>
-<span class="source-line-no">103</span><span id="line-103"></span>
-<span class="source-line-no">104</span><span id="line-104"> /**</span>
-<span class="source-line-no">105</span><span id="line-105"> * Gets the
current month.</span>
-<span class="source-line-no">106</span><span id="line-106"> *</span>
-<span class="source-line-no">107</span><span id="line-107"> * @return the
current month.</span>
-<span class="source-line-no">108</span><span id="line-108"> */</span>
-<span class="source-line-no">109</span><span id="line-109"> public int
getMonth() {</span>
-<span class="source-line-no">110</span><span id="line-110"> return
calendar.get(Calendar.MONTH);</span>
-<span class="source-line-no">111</span><span id="line-111"> }</span>
-<span class="source-line-no">112</span><span id="line-112"></span>
-<span class="source-line-no">113</span><span id="line-113"> /**</span>
-<span class="source-line-no">114</span><span id="line-114"> * Gets month
names in the requested style.</span>
-<span class="source-line-no">115</span><span id="line-115"> * @param style
Must be a valid {@link Calendar#getDisplayNames(int, int, Locale)} month
style.</span>
-<span class="source-line-no">116</span><span id="line-116"> * @return
Styled names of months</span>
-<span class="source-line-no">117</span><span id="line-117"> */</span>
-<span class="source-line-no">118</span><span id="line-118"> String[]
getMonthDisplayNames(final int style) {</span>
-<span class="source-line-no">119</span><span id="line-119"> //
Unfortunately standalone month names are not available in
DateFormatSymbols,</span>
-<span class="source-line-no">120</span><span id="line-120"> // so we
have to extract them.</span>
-<span class="source-line-no">121</span><span id="line-121"> final
Map<String, Integer> displayNames =
calendar.getDisplayNames(Calendar.MONTH, style, locale);</span>
-<span class="source-line-no">122</span><span id="line-122"> if
(displayNames == null) {</span>
-<span class="source-line-no">123</span><span id="line-123"> return
null;</span>
-<span class="source-line-no">124</span><span id="line-124"> }</span>
-<span class="source-line-no">125</span><span id="line-125"> final
String[] monthNames = new String[displayNames.size()];</span>
-<span class="source-line-no">126</span><span id="line-126">
displayNames.forEach((k, v) -> monthNames[v] = k);</span>
-<span class="source-line-no">127</span><span id="line-127"> return
monthNames;</span>
-<span class="source-line-no">128</span><span id="line-128"> }</span>
-<span class="source-line-no">129</span><span id="line-129"></span>
-<span class="source-line-no">130</span><span id="line-130"> /**</span>
-<span class="source-line-no">131</span><span id="line-131"> * Gets full
standalone month names as used in "LLLL" date formatting.</span>
-<span class="source-line-no">132</span><span id="line-132"> * @return Long
names of months</span>
-<span class="source-line-no">133</span><span id="line-133"> */</span>
-<span class="source-line-no">134</span><span id="line-134"> String[]
getStandaloneLongMonthNames() {</span>
-<span class="source-line-no">135</span><span id="line-135"> return
getMonthDisplayNames(Calendar.LONG_STANDALONE);</span>
-<span class="source-line-no">136</span><span id="line-136"> }</span>
-<span class="source-line-no">137</span><span id="line-137"></span>
-<span class="source-line-no">138</span><span id="line-138"> /**</span>
-<span class="source-line-no">139</span><span id="line-139"> * Gets short
standalone month names as used in "LLLL" date formatting.</span>
-<span class="source-line-no">140</span><span id="line-140"> * @return
Short names of months</span>
-<span class="source-line-no">141</span><span id="line-141"> */</span>
-<span class="source-line-no">142</span><span id="line-142"> String[]
getStandaloneShortMonthNames() {</span>
-<span class="source-line-no">143</span><span id="line-143"> return
getMonthDisplayNames(Calendar.SHORT_STANDALONE);</span>
-<span class="source-line-no">144</span><span id="line-144"> }</span>
-<span class="source-line-no">145</span><span id="line-145"></span>
-<span class="source-line-no">146</span><span id="line-146"> /**</span>
-<span class="source-line-no">147</span><span id="line-147"> * Gets the
current year.</span>
-<span class="source-line-no">148</span><span id="line-148"> *</span>
-<span class="source-line-no">149</span><span id="line-149"> * @return the
current year.</span>
-<span class="source-line-no">150</span><span id="line-150"> */</span>
-<span class="source-line-no">151</span><span id="line-151"> public int
getYear() {</span>
-<span class="source-line-no">152</span><span id="line-152"> return
calendar.get(Calendar.YEAR);</span>
-<span class="source-line-no">153</span><span id="line-153"> }</span>
-<span class="source-line-no">154</span><span id="line-154">}</span>
+<span class="source-line-no">069</span><span id="line-69"> * @param
calendar the Calendar to convert.</span>
+<span class="source-line-no">070</span><span id="line-70"> * @return a
LocalDateTime.</span>
+<span class="source-line-no">071</span><span id="line-71"> * @since
3.17.0</span>
+<span class="source-line-no">072</span><span id="line-72"> */</span>
+<span class="source-line-no">073</span><span id="line-73"> public static
LocalDateTime toLocalDateTime(final Calendar calendar) {</span>
+<span class="source-line-no">074</span><span id="line-74"> return
LocalDateTime.ofInstant(calendar.toInstant(), toZoneId(calendar));</span>
+<span class="source-line-no">075</span><span id="line-75"> }</span>
+<span class="source-line-no">076</span><span id="line-76"></span>
+<span class="source-line-no">077</span><span id="line-77"> /**</span>
+<span class="source-line-no">078</span><span id="line-78"> * Converts a
Calendar to a OffsetDateTime.</span>
+<span class="source-line-no">079</span><span id="line-79"> *</span>
+<span class="source-line-no">080</span><span id="line-80"> * @param
calendar the Calendar to convert.</span>
+<span class="source-line-no">081</span><span id="line-81"> * @return a
OffsetDateTime.</span>
+<span class="source-line-no">082</span><span id="line-82"> * @since
3.17.0</span>
+<span class="source-line-no">083</span><span id="line-83"> */</span>
+<span class="source-line-no">084</span><span id="line-84"> public static
OffsetDateTime toOffsetDateTime(final Calendar calendar) {</span>
+<span class="source-line-no">085</span><span id="line-85"> return
OffsetDateTime.ofInstant(calendar.toInstant(), toZoneId(calendar));</span>
+<span class="source-line-no">086</span><span id="line-86"> }</span>
+<span class="source-line-no">087</span><span id="line-87"></span>
+<span class="source-line-no">088</span><span id="line-88"> /**</span>
+<span class="source-line-no">089</span><span id="line-89"> * Converts a
Calendar to a ZonedDateTime.</span>
+<span class="source-line-no">090</span><span id="line-90"> *</span>
+<span class="source-line-no">091</span><span id="line-91"> * @param
calendar the Calendar to convert.</span>
+<span class="source-line-no">092</span><span id="line-92"> * @return a
ZonedDateTime.</span>
+<span class="source-line-no">093</span><span id="line-93"> * @since
3.17.0</span>
+<span class="source-line-no">094</span><span id="line-94"> */</span>
+<span class="source-line-no">095</span><span id="line-95"> public static
ZonedDateTime toZonedDateTime(final Calendar calendar) {</span>
+<span class="source-line-no">096</span><span id="line-96"> return
ZonedDateTime.ofInstant(calendar.toInstant(), toZoneId(calendar));</span>
+<span class="source-line-no">097</span><span id="line-97"> }</span>
+<span class="source-line-no">098</span><span id="line-98"></span>
+<span class="source-line-no">099</span><span id="line-99"> private static
ZoneId toZoneId(final Calendar calendar) {</span>
+<span class="source-line-no">100</span><span id="line-100"> return
calendar.getTimeZone().toZoneId();</span>
+<span class="source-line-no">101</span><span id="line-101"> }</span>
+<span class="source-line-no">102</span><span id="line-102"></span>
+<span class="source-line-no">103</span><span id="line-103"> private final
Calendar calendar;</span>
+<span class="source-line-no">104</span><span id="line-104"></span>
+<span class="source-line-no">105</span><span id="line-105"> private final
Locale locale;</span>
+<span class="source-line-no">106</span><span id="line-106"></span>
+<span class="source-line-no">107</span><span id="line-107"> /**</span>
+<span class="source-line-no">108</span><span id="line-108"> * Creates an
instance for the given Calendar.</span>
+<span class="source-line-no">109</span><span id="line-109"> *</span>
+<span class="source-line-no">110</span><span id="line-110"> * @param
calendar A Calendar.</span>
+<span class="source-line-no">111</span><span id="line-111"> */</span>
+<span class="source-line-no">112</span><span id="line-112"> public
CalendarUtils(final Calendar calendar) {</span>
+<span class="source-line-no">113</span><span id="line-113">
this(calendar, Locale.getDefault());</span>
+<span class="source-line-no">114</span><span id="line-114"> }</span>
+<span class="source-line-no">115</span><span id="line-115"> /**</span>
+<span class="source-line-no">116</span><span id="line-116"> * Creates an
instance for the given Calendar.</span>
+<span class="source-line-no">117</span><span id="line-117"> *</span>
+<span class="source-line-no">118</span><span id="line-118"> * @param
calendar A Calendar.</span>
+<span class="source-line-no">119</span><span id="line-119"> * @param
locale A Locale.</span>
+<span class="source-line-no">120</span><span id="line-120"> */</span>
+<span class="source-line-no">121</span><span id="line-121">
CalendarUtils(final Calendar calendar, final Locale locale) {</span>
+<span class="source-line-no">122</span><span id="line-122">
this.calendar = Objects.requireNonNull(calendar, "calendar");</span>
+<span class="source-line-no">123</span><span id="line-123"> this.locale
= Objects.requireNonNull(locale, "locale");</span>
+<span class="source-line-no">124</span><span id="line-124"> }</span>
+<span class="source-line-no">125</span><span id="line-125"></span>
+<span class="source-line-no">126</span><span id="line-126"> /**</span>
+<span class="source-line-no">127</span><span id="line-127"> * Gets the
current day of month.</span>
+<span class="source-line-no">128</span><span id="line-128"> *</span>
+<span class="source-line-no">129</span><span id="line-129"> * @return the
current day of month.</span>
+<span class="source-line-no">130</span><span id="line-130"> */</span>
+<span class="source-line-no">131</span><span id="line-131"> public int
getDayOfMonth() {</span>
+<span class="source-line-no">132</span><span id="line-132"> return
calendar.get(Calendar.DAY_OF_MONTH);</span>
+<span class="source-line-no">133</span><span id="line-133"> }</span>
+<span class="source-line-no">134</span><span id="line-134"></span>
+<span class="source-line-no">135</span><span id="line-135"> /**</span>
+<span class="source-line-no">136</span><span id="line-136"> * Gets the
current day of year.</span>
+<span class="source-line-no">137</span><span id="line-137"> *</span>
+<span class="source-line-no">138</span><span id="line-138"> * @return the
current day of year.</span>
+<span class="source-line-no">139</span><span id="line-139"> * @since
3.13.0</span>
+<span class="source-line-no">140</span><span id="line-140"> */</span>
+<span class="source-line-no">141</span><span id="line-141"> public int
getDayOfYear() {</span>
+<span class="source-line-no">142</span><span id="line-142"> return
calendar.get(Calendar.DAY_OF_YEAR);</span>
+<span class="source-line-no">143</span><span id="line-143"> }</span>
+<span class="source-line-no">144</span><span id="line-144"></span>
+<span class="source-line-no">145</span><span id="line-145"> /**</span>
+<span class="source-line-no">146</span><span id="line-146"> * Gets the
current month.</span>
+<span class="source-line-no">147</span><span id="line-147"> *</span>
+<span class="source-line-no">148</span><span id="line-148"> * @return the
current month.</span>
+<span class="source-line-no">149</span><span id="line-149"> */</span>
+<span class="source-line-no">150</span><span id="line-150"> public int
getMonth() {</span>
+<span class="source-line-no">151</span><span id="line-151"> return
calendar.get(Calendar.MONTH);</span>
+<span class="source-line-no">152</span><span id="line-152"> }</span>
+<span class="source-line-no">153</span><span id="line-153"></span>
+<span class="source-line-no">154</span><span id="line-154"> /**</span>
+<span class="source-line-no">155</span><span id="line-155"> * Gets month
names in the requested style.</span>
+<span class="source-line-no">156</span><span id="line-156"> * @param style
Must be a valid {@link Calendar#getDisplayNames(int, int, Locale)} month
style.</span>
+<span class="source-line-no">157</span><span id="line-157"> * @return
Styled names of months</span>
+<span class="source-line-no">158</span><span id="line-158"> */</span>
+<span class="source-line-no">159</span><span id="line-159"> String[]
getMonthDisplayNames(final int style) {</span>
+<span class="source-line-no">160</span><span id="line-160"> //
Unfortunately standalone month names are not available in
DateFormatSymbols,</span>
+<span class="source-line-no">161</span><span id="line-161"> // so we
have to extract them.</span>
+<span class="source-line-no">162</span><span id="line-162"> final
Map<String, Integer> displayNames =
calendar.getDisplayNames(Calendar.MONTH, style, locale);</span>
+<span class="source-line-no">163</span><span id="line-163"> if
(displayNames == null) {</span>
+<span class="source-line-no">164</span><span id="line-164"> return
null;</span>
+<span class="source-line-no">165</span><span id="line-165"> }</span>
+<span class="source-line-no">166</span><span id="line-166"> final
String[] monthNames = new String[displayNames.size()];</span>
+<span class="source-line-no">167</span><span id="line-167">
displayNames.forEach((k, v) -> monthNames[v] = k);</span>
+<span class="source-line-no">168</span><span id="line-168"> return
monthNames;</span>
+<span class="source-line-no">169</span><span id="line-169"> }</span>
+<span class="source-line-no">170</span><span id="line-170"></span>
+<span class="source-line-no">171</span><span id="line-171"> /**</span>
+<span class="source-line-no">172</span><span id="line-172"> * Gets full
standalone month names as used in "LLLL" date formatting.</span>
+<span class="source-line-no">173</span><span id="line-173"> * @return Long
names of months</span>
+<span class="source-line-no">174</span><span id="line-174"> */</span>
+<span class="source-line-no">175</span><span id="line-175"> String[]
getStandaloneLongMonthNames() {</span>
+<span class="source-line-no">176</span><span id="line-176"> return
getMonthDisplayNames(Calendar.LONG_STANDALONE);</span>
+<span class="source-line-no">177</span><span id="line-177"> }</span>
+<span class="source-line-no">178</span><span id="line-178"></span>
+<span class="source-line-no">179</span><span id="line-179"> /**</span>
+<span class="source-line-no">180</span><span id="line-180"> * Gets short
standalone month names as used in "LLLL" date formatting.</span>
+<span class="source-line-no">181</span><span id="line-181"> * @return
Short names of months</span>
+<span class="source-line-no">182</span><span id="line-182"> */</span>
+<span class="source-line-no">183</span><span id="line-183"> String[]
getStandaloneShortMonthNames() {</span>
+<span class="source-line-no">184</span><span id="line-184"> return
getMonthDisplayNames(Calendar.SHORT_STANDALONE);</span>
+<span class="source-line-no">185</span><span id="line-185"> }</span>
+<span class="source-line-no">186</span><span id="line-186"></span>
+<span class="source-line-no">187</span><span id="line-187"> /**</span>
+<span class="source-line-no">188</span><span id="line-188"> * Gets the
current year.</span>
+<span class="source-line-no">189</span><span id="line-189"> *</span>
+<span class="source-line-no">190</span><span id="line-190"> * @return the
current year.</span>
+<span class="source-line-no">191</span><span id="line-191"> */</span>
+<span class="source-line-no">192</span><span id="line-192"> public int
getYear() {</span>
+<span class="source-line-no">193</span><span id="line-193"> return
calendar.get(Calendar.YEAR);</span>
+<span class="source-line-no">194</span><span id="line-194"> }</span>
+<span class="source-line-no">195</span><span id="line-195"></span>
+<span class="source-line-no">196</span><span id="line-196"> /**</span>
+<span class="source-line-no">197</span><span id="line-197"> * Converts
this instance to a {@link LocalDateTime}.</span>
+<span class="source-line-no">198</span><span id="line-198"> *</span>
+<span class="source-line-no">199</span><span id="line-199"> * @return a
LocalDateTime.</span>
+<span class="source-line-no">200</span><span id="line-200"> * @since
3.17.0</span>
+<span class="source-line-no">201</span><span id="line-201"> */</span>
+<span class="source-line-no">202</span><span id="line-202"> public
LocalDateTime toLocalDateTime() {</span>
+<span class="source-line-no">203</span><span id="line-203"> return
toLocalDateTime(calendar);</span>
+<span class="source-line-no">204</span><span id="line-204"> }</span>
+<span class="source-line-no">205</span><span id="line-205"></span>
+<span class="source-line-no">206</span><span id="line-206"> /**</span>
+<span class="source-line-no">207</span><span id="line-207"> * Converts
this instance to a {@link OffsetDateTime}.</span>
+<span class="source-line-no">208</span><span id="line-208"> *</span>
+<span class="source-line-no">209</span><span id="line-209"> * @return a
OffsetDateTime.</span>
+<span class="source-line-no">210</span><span id="line-210"> * @since
3.17.0</span>
+<span class="source-line-no">211</span><span id="line-211"> */</span>
+<span class="source-line-no">212</span><span id="line-212"> public
OffsetDateTime toOffsetDateTime() {</span>
+<span class="source-line-no">213</span><span id="line-213"> return
toOffsetDateTime(calendar);</span>
+<span class="source-line-no">214</span><span id="line-214"> }</span>
+<span class="source-line-no">215</span><span id="line-215"></span>
+<span class="source-line-no">216</span><span id="line-216"> /**</span>
+<span class="source-line-no">217</span><span id="line-217"> * Converts
this instance to a {@link ZonedDateTime}.</span>
+<span class="source-line-no">218</span><span id="line-218"> *</span>
+<span class="source-line-no">219</span><span id="line-219"> * @return a
ZonedDateTime.</span>
+<span class="source-line-no">220</span><span id="line-220"> * @since
3.17.0</span>
+<span class="source-line-no">221</span><span id="line-221"> */</span>
+<span class="source-line-no">222</span><span id="line-222"> public
ZonedDateTime toZonedDateTime() {</span>
+<span class="source-line-no">223</span><span id="line-223"> return
toZonedDateTime(calendar);</span>
+<span class="source-line-no">224</span><span id="line-224"> }</span>
+<span class="source-line-no">225</span><span id="line-225"></span>
+<span class="source-line-no">226</span><span id="line-226">}</span>
Modified:
websites/production/commons/content/proper/commons-lang/article2_4.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/article2_4.html
(original)
+++ websites/production/commons/content/proper/commons-lang/article2_4.html Thu
Aug 29 19:59:17 2024
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 07 August 2024
+ | Generated by Apache Maven Doxia at 29 August 2024
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20240807" />
+ <meta name="Date-Revision-yyyymmdd" content="20240829" />
<meta http-equiv="Content-Language" content="en" />
<title>Lang – What's new in Commons Lang 2.4?</title>
@@ -41,8 +41,8 @@
<a class="brand"
href="https://commons.apache.org/proper/commons-lang/";>Apache Commons Lang
™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 07 August 2024</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 3.16.0</li>
+ <li id="publishDate">Last Published: 29 August 2024</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 3.17.0</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
Modified:
websites/production/commons/content/proper/commons-lang/article2_5.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/article2_5.html
(original)
+++ websites/production/commons/content/proper/commons-lang/article2_5.html Thu
Aug 29 19:59:17 2024
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 07 August 2024
+ | Generated by Apache Maven Doxia at 29 August 2024
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20240807" />
+ <meta name="Date-Revision-yyyymmdd" content="20240829" />
<meta http-equiv="Content-Language" content="en" />
<title>Lang – What's new in Commons Lang 2.5?</title>
@@ -41,8 +41,8 @@
<a class="brand"
href="https://commons.apache.org/proper/commons-lang/";>Apache Commons Lang
™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 07 August 2024</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 3.16.0</li>
+ <li id="publishDate">Last Published: 29 August 2024</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 3.17.0</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
Modified:
websites/production/commons/content/proper/commons-lang/article3_0.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/article3_0.html
(original)
+++ websites/production/commons/content/proper/commons-lang/article3_0.html Thu
Aug 29 19:59:17 2024
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 07 August 2024
+ | Generated by Apache Maven Doxia at 29 August 2024
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20240807" />
+ <meta name="Date-Revision-yyyymmdd" content="20240829" />
<meta http-equiv="Content-Language" content="en" />
<title>Lang – What's new in Commons Lang 3.0?</title>
@@ -41,8 +41,8 @@
<a class="brand"
href="https://commons.apache.org/proper/commons-lang/";>Apache Commons Lang
™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 07 August 2024</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 3.16.0</li>
+ <li id="publishDate">Last Published: 29 August 2024</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 3.17.0</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
Modified: websites/production/commons/content/proper/commons-lang/building.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/building.html
(original)
+++ websites/production/commons/content/proper/commons-lang/building.html Thu
Aug 29 19:59:17 2024
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
- | Generated by Apache Maven Doxia at 07 August 2024
+ | Generated by Apache Maven Doxia at 29 August 2024
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
@@ -8,7 +8,7 @@
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="author" content="Commons Documentation Team" />
- <meta name="Date-Revision-yyyymmdd" content="20240807" />
+ <meta name="Date-Revision-yyyymmdd" content="20240829" />
<meta http-equiv="Content-Language" content="en" />
<title>Lang – Building</title>
@@ -41,8 +41,8 @@
<a class="brand"
href="https://commons.apache.org/proper/commons-lang/";>Apache Commons Lang
™</a>
<ul class="nav">
- <li id="publishDate">Last Published: 07 August 2024</li>
- <li class="divider">|</li> <li id="projectVersion">Version: 3.16.0</li>
+ <li id="publishDate">Last Published: 29 August 2024</li>
+ <li class="divider">|</li> <li id="projectVersion">Version: 3.17.0</li>
</ul>
<div class="pull-right"> <ul class="nav">
<li>
