1 package org.djunits.value.vdouble.scalar;
2
3 import java.util.Locale;
4
5 import org.djunits.unit.AngleUnit;
6 import org.djunits.unit.AngularVelocityUnit;
7 import org.djunits.unit.DimensionlessUnit;
8 import org.djunits.unit.DurationUnit;
9 import org.djunits.unit.ElectricalCapacitanceUnit;
10 import org.djunits.unit.ElectricalChargeUnit;
11 import org.djunits.unit.ElectricalInductanceUnit;
12 import org.djunits.unit.EnergyUnit;
13 import org.djunits.unit.LengthUnit;
14 import org.djunits.unit.MagneticFluxUnit;
15 import org.djunits.unit.MassUnit;
16 import org.djunits.unit.SpeedUnit;
17 import org.djunits.unit.TimeUnit;
18 import org.djunits.unit.VolumeUnit;
19 import org.djunits.value.vdouble.scalar.base.AbstractDoubleScalarRelWithAbs;
20 import org.djutils.base.NumberParser;
21 import org.djutils.exceptions.Throw;
22
23 import jakarta.annotation.Generated;
24
25
26
27
28
29
30
31
32
33
34
35 @Generated(value = "org.djunits.generator.GenerateDJUNIT", date = "2023-04-30T13:59:27.633664900Z")
36 public class Duration extends AbstractDoubleScalarRelWithAbs<TimeUnit, Time, DurationUnit, Duration>
37 {
38
39 private static final long serialVersionUID = 20150901L;
40
41
42 public static final Duration ZERO = new Duration(0.0, DurationUnit.SI);
43
44
45 public static final Duration ONE = new Duration(1.0, DurationUnit.SI);
46
47
48 @SuppressWarnings("checkstyle:constantname")
49 public static final Duration NaN = new Duration(Double.NaN, DurationUnit.SI);
50
51
52 public static final Duration POSITIVE_INFINITY = new Duration(Double.POSITIVE_INFINITY, DurationUnit.SI);
53
54
55 public static final Duration NEGATIVE_INFINITY = new Duration(Double.NEGATIVE_INFINITY, DurationUnit.SI);
56
57
58 public static final Duration POS_MAXVALUE = new Duration(Double.MAX_VALUE, DurationUnit.SI);
59
60
61 public static final Duration NEG_MAXVALUE = new Duration(-Double.MAX_VALUE, DurationUnit.SI);
62
63
64
65
66
67
68 public Duration(final double value, final DurationUnit unit)
69 {
70 super(value, unit);
71 }
72
73
74
75
76
77 public Duration(final Duration value)
78 {
79 super(value);
80 }
81
82
83 @Override
84 public final Duration instantiateRel(final double value, final DurationUnit unit)
85 {
86 return new Duration(value, unit);
87 }
88
89
90 @Override
91 public final Time instantiateAbs(final double value, final TimeUnit unit)
92 {
93 return new Time(value, unit);
94 }
95
96
97
98
99
100
101 public static final Duration instantiateSI(final double value)
102 {
103 return new Duration(value, DurationUnit.SI);
104 }
105
106
107
108
109
110
111
112
113 public static Duration interpolate(final Duration zero, final Duration one, final double ratio)
114 {
115 return new Duration(zero.getInUnit() * (1 - ratio) + one.getInUnit(zero.getDisplayUnit()) * ratio,
116 zero.getDisplayUnit());
117 }
118
119
120
121
122
123
124
125 public static Duration max(final Duration r1, final Duration r2)
126 {
127 return r1.gt(r2) ? r1 : r2;
128 }
129
130
131
132
133
134
135
136
137 public static Duration max(final Duration r1, final Duration r2, final Duration... rn)
138 {
139 Duration maxr = r1.gt(r2) ? r1 : r2;
140 for (Duration r : rn)
141 {
142 if (r.gt(maxr))
143 {
144 maxr = r;
145 }
146 }
147 return maxr;
148 }
149
150
151
152
153
154
155
156 public static Duration min(final Duration r1, final Duration r2)
157 {
158 return r1.lt(r2) ? r1 : r2;
159 }
160
161
162
163
164
165
166
167
168 public static Duration min(final Duration r1, final Duration r2, final Duration... rn)
169 {
170 Duration minr = r1.lt(r2) ? r1 : r2;
171 for (Duration r : rn)
172 {
173 if (r.lt(minr))
174 {
175 minr = r;
176 }
177 }
178 return minr;
179 }
180
181
182
183
184
185
186
187
188
189
190 public static Duration valueOf(final String text)
191 {
192 Throw.whenNull(text, "Error parsing Duration: text to parse is null");
193 Throw.when(text.length() == 0, IllegalArgumentException.class, "Error parsing Duration: empty text to parse");
194 try
195 {
196 NumberParser numberParser = new NumberParser().lenient().trailing();
197 double d = numberParser.parseDouble(text);
198 String unitString = text.substring(numberParser.getTrailingPosition()).trim();
199 DurationUnit unit = DurationUnit.BASE.getUnitByAbbreviation(unitString);
200 if (unit == null)
201 throw new IllegalArgumentException("Unit " + unitString + " not found");
202 return new Duration(d, unit);
203 }
204 catch (Exception exception)
205 {
206 throw new IllegalArgumentException(
207 "Error parsing Duration from " + text + " using Locale " + Locale.getDefault(Locale.Category.FORMAT),
208 exception);
209 }
210 }
211
212
213
214
215
216
217
218
219
220 public static Duration of(final double value, final String unitString)
221 {
222 Throw.whenNull(unitString, "Error parsing Duration: unitString is null");
223 Throw.when(unitString.length() == 0, IllegalArgumentException.class, "Error parsing Duration: empty unitString");
224 DurationUnit unit = DurationUnit.BASE.getUnitByAbbreviation(unitString);
225 if (unit != null)
226 {
227 return new Duration(value, unit);
228 }
229 throw new IllegalArgumentException("Error parsing Duration with unit " + unitString);
230 }
231
232
233
234
235
236
237 public final Dimensionless divide(final Duration v)
238 {
239 return new Dimensionless(this.si / v.si, DimensionlessUnit.SI);
240 }
241
242
243
244
245
246
247 public final Dimensionless times(final Frequency v)
248 {
249 return new Dimensionless(this.si * v.si, DimensionlessUnit.SI);
250 }
251
252
253
254
255
256
257 public final ElectricalCharge times(final ElectricalCurrent v)
258 {
259 return new ElectricalCharge(this.si * v.si, ElectricalChargeUnit.SI);
260 }
261
262
263
264
265
266
267 public final Mass times(final FlowMass v)
268 {
269 return new Mass(this.si * v.si, MassUnit.SI);
270 }
271
272
273
274
275
276
277 public final Volume times(final FlowVolume v)
278 {
279 return new Volume(this.si * v.si, VolumeUnit.SI);
280 }
281
282
283
284
285
286
287 public final Speed times(final Acceleration v)
288 {
289 return new Speed(this.si * v.si, SpeedUnit.SI);
290 }
291
292
293
294
295
296
297 public final Energy times(final Power v)
298 {
299 return new Energy(this.si * v.si, EnergyUnit.SI);
300 }
301
302
303
304
305
306
307 public final Length times(final Speed v)
308 {
309 return new Length(this.si * v.si, LengthUnit.SI);
310 }
311
312
313
314
315
316
317 public final MagneticFlux times(final ElectricalPotential v)
318 {
319 return new MagneticFlux(this.si * v.si, MagneticFluxUnit.SI);
320 }
321
322
323
324
325
326
327 public final ElectricalInductance times(final ElectricalResistance v)
328 {
329 return new ElectricalInductance(this.si * v.si, ElectricalInductanceUnit.SI);
330 }
331
332
333
334
335
336
337 public final ElectricalCapacitance times(final ElectricalConductance v)
338 {
339 return new ElectricalCapacitance(this.si * v.si, ElectricalCapacitanceUnit.SI);
340 }
341
342
343
344
345
346
347 public final Angle times(final AngularVelocity v)
348 {
349 return new Angle(this.si * v.si, AngleUnit.SI);
350 }
351
352
353
354
355
356
357 public final AngularVelocity times(final AngularAcceleration v)
358 {
359 return new AngularVelocity(this.si * v.si, AngularVelocityUnit.SI);
360 }
361
362
363 @Override
364 public Frequency reciprocal()
365 {
366 return Frequency.instantiateSI(1.0 / this.si);
367 }
368
369 }