forked from bjmashibing/java
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathInstant.html
More file actions
1900 lines (1898 loc) · 102 KB
/
Copy pathInstant.html
File metadata and controls
1900 lines (1898 loc) · 102 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc -->
<title>Instant (Java SE 12 & JDK 12 )</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="keywords" content="java.time.Instant class">
<meta name="keywords" content="EPOCH">
<meta name="keywords" content="MIN">
<meta name="keywords" content="MAX">
<meta name="keywords" content="now()">
<meta name="keywords" content="ofEpochSecond()">
<meta name="keywords" content="ofEpochMilli()">
<meta name="keywords" content="from()">
<meta name="keywords" content="parse()">
<meta name="keywords" content="isSupported()">
<meta name="keywords" content="range()">
<meta name="keywords" content="get()">
<meta name="keywords" content="getLong()">
<meta name="keywords" content="getEpochSecond()">
<meta name="keywords" content="getNano()">
<meta name="keywords" content="with()">
<meta name="keywords" content="truncatedTo()">
<meta name="keywords" content="plus()">
<meta name="keywords" content="plusSeconds()">
<meta name="keywords" content="plusMillis()">
<meta name="keywords" content="plusNanos()">
<meta name="keywords" content="minus()">
<meta name="keywords" content="minusSeconds()">
<meta name="keywords" content="minusMillis()">
<meta name="keywords" content="minusNanos()">
<meta name="keywords" content="query()">
<meta name="keywords" content="adjustInto()">
<meta name="keywords" content="until()">
<meta name="keywords" content="atOffset()">
<meta name="keywords" content="atZone()">
<meta name="keywords" content="toEpochMilli()">
<meta name="keywords" content="compareTo()">
<meta name="keywords" content="isAfter()">
<meta name="keywords" content="isBefore()">
<meta name="keywords" content="equals()">
<meta name="keywords" content="hashCode()">
<meta name="keywords" content="toString()">
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../jquery/jquery-ui.css" title="Style">
<script type="text/javascript" src="../../../script.js"></script>
<script type="text/javascript" src="../../../jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="../../../jquery/jquery-3.3.1.js"></script>
<script type="text/javascript" src="../../../jquery/jquery-migrate-3.0.1.js"></script>
<script type="text/javascript" src="../../../jquery/jquery-ui.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="Instant (Java SE 12 & JDK 12 )";
}
}
catch(err) {
}
//-->
var data = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":9,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":9,"i21":9,"i22":9,"i23":9,"i24":9,"i25":9,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10};
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
var pathtoroot = "../../../";
var useModuleDirectories = true;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<header role="banner">
<nav role="navigation">
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a id="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../index.html">Overview</a></li>
<li><a href="../../module-summary.html">Module</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/Instant.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../index-files/index-1.html">Index</a></li>
<li><a href="../../../help-doc.html">Help</a></li>
</ul>
<div class="aboutLanguage"><div style="margin-top: 14px;"><strong>Java SE 12 & JDK 12</strong> </div></div>
</div>
<div class="subNav">
<div>
<ul class="subNavList">
<li>Summary: </li>
<li>Nested | </li>
<li><a href="#field.summary">Field</a> | </li>
<li>Constr | </li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail: </li>
<li><a href="#field.detail">Field</a> | </li>
<li>Constr | </li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</li>
</ul>
</div>
<a id="skip.navbar.top">
<!-- -->
</a>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding"> </div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
</nav>
</header>
<!-- ======== START OF CLASS DATA ======== -->
<main role="main">
<div class="header">
<div class="subTitle"><span class="moduleLabelInType">Module</span> <a href="../../module-summary.html">java.base</a></div>
<div class="subTitle"><span class="packageLabelInType">Package</span> <a href="package-summary.html">java.time</a></div>
<h2 title="Class Instant" class="title">Class Instant</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="../lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>java.time.Instant</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><code><a href="../io/Serializable.html" title="interface in java.io">Serializable</a></code>, <code><a href="../lang/Comparable.html" title="interface in java.lang">Comparable</a><<a href="Instant.html" title="class in java.time">Instant</a>></code>, <code><a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a></code>, <code><a href="temporal/TemporalAccessor.html" title="interface in java.time.temporal">TemporalAccessor</a></code>, <code><a href="temporal/TemporalAdjuster.html" title="interface in java.time.temporal">TemporalAdjuster</a></code></dd>
</dl>
<hr>
<pre>public final class <span class="typeNameLabel">Instant</span>
extends <a href="../lang/Object.html" title="class in java.lang">Object</a>
implements <a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a>, <a href="temporal/TemporalAdjuster.html" title="interface in java.time.temporal">TemporalAdjuster</a>, <a href="../lang/Comparable.html" title="interface in java.lang">Comparable</a><<a href="Instant.html" title="class in java.time">Instant</a>>, <a href="../io/Serializable.html" title="interface in java.io">Serializable</a></pre>
<div class="block">An instantaneous point on the time-line.
<p>
This class models a single instantaneous point on the time-line.
This might be used to record event time-stamps in the application.
<p>
The range of an instant requires the storage of a number larger than a <code>long</code>.
To achieve this, the class stores a <code>long</code> representing epoch-seconds and an
<code>int</code> representing nanosecond-of-second, which will always be between 0 and 999,999,999.
The epoch-seconds are measured from the standard Java epoch of <code>1970-01-01T00:00:00Z</code>
where instants after the epoch have positive values, and earlier instants have negative values.
For both the epoch-second and nanosecond parts, a larger value is always later on the time-line
than a smaller value.
<h3>Time-scale</h3>
<p>
The length of the solar day is the standard way that humans measure time.
This has traditionally been subdivided into 24 hours of 60 minutes of 60 seconds,
forming a 86400 second day.
<p>
Modern timekeeping is based on atomic clocks which precisely define an SI second
relative to the transitions of a Caesium atom. The length of an SI second was defined
to be very close to the 86400th fraction of a day.
<p>
Unfortunately, as the Earth rotates the length of the day varies.
In addition, over time the average length of the day is getting longer as the Earth slows.
As a result, the length of a solar day in 2012 is slightly longer than 86400 SI seconds.
The actual length of any given day and the amount by which the Earth is slowing
are not predictable and can only be determined by measurement.
The UT1 time-scale captures the accurate length of day, but is only available some
time after the day has completed.
<p>
The UTC time-scale is a standard approach to bundle up all the additional fractions
of a second from UT1 into whole seconds, known as <i>leap-seconds</i>.
A leap-second may be added or removed depending on the Earth's rotational changes.
As such, UTC permits a day to have 86399 SI seconds or 86401 SI seconds where
necessary in order to keep the day aligned with the Sun.
<p>
The modern UTC time-scale was introduced in 1972, introducing the concept of whole leap-seconds.
Between 1958 and 1972, the definition of UTC was complex, with minor sub-second leaps and
alterations to the length of the notional second. As of 2012, discussions are underway
to change the definition of UTC again, with the potential to remove leap seconds or
introduce other changes.
<p>
Given the complexity of accurate timekeeping described above, this Java API defines
its own time-scale, the <i>Java Time-Scale</i>.
<p>
The Java Time-Scale divides each calendar day into exactly 86400
subdivisions, known as seconds. These seconds may differ from the
SI second. It closely matches the de facto international civil time
scale, the definition of which changes from time to time.
<p>
The Java Time-Scale has slightly different definitions for different
segments of the time-line, each based on the consensus international
time scale that is used as the basis for civil time. Whenever the
internationally-agreed time scale is modified or replaced, a new
segment of the Java Time-Scale must be defined for it. Each segment
must meet these requirements:
<ul>
<li>the Java Time-Scale shall closely match the underlying international
civil time scale;</li>
<li>the Java Time-Scale shall exactly match the international civil
time scale at noon each day;</li>
<li>the Java Time-Scale shall have a precisely-defined relationship to
the international civil time scale.</li>
</ul>
There are currently, as of 2013, two segments in the Java time-scale.
<p>
For the segment from 1972-11-03 (exact boundary discussed below) until
further notice, the consensus international time scale is UTC (with
leap seconds). In this segment, the Java Time-Scale is identical to
<a href="http://www.cl.cam.ac.uk/~mgk25/time/utc-sls/">UTC-SLS</a>.
This is identical to UTC on days that do not have a leap second.
On days that do have a leap second, the leap second is spread equally
over the last 1000 seconds of the day, maintaining the appearance of
exactly 86400 seconds per day.
<p>
For the segment prior to 1972-11-03, extending back arbitrarily far,
the consensus international time scale is defined to be UT1, applied
proleptically, which is equivalent to the (mean) solar time on the
prime meridian (Greenwich). In this segment, the Java Time-Scale is
identical to the consensus international time scale. The exact
boundary between the two segments is the instant where UT1 = UTC
between 1972-11-03T00:00 and 1972-11-04T12:00.
<p>
Implementations of the Java time-scale using the JSR-310 API are not
required to provide any clock that is sub-second accurate, or that
progresses monotonically or smoothly. Implementations are therefore
not required to actually perform the UTC-SLS slew or to otherwise be
aware of leap seconds. JSR-310 does, however, require that
implementations must document the approach they use when defining a
clock representing the current instant.
See <a href="Clock.html" title="class in java.time"><code>Clock</code></a> for details on the available clocks.
<p>
The Java time-scale is used for all date-time classes.
This includes <code>Instant</code>, <code>LocalDate</code>, <code>LocalTime</code>, <code>OffsetDateTime</code>,
<code>ZonedDateTime</code> and <code>Duration</code>.
<p>
This is a <a href="../../../java.base/java/lang/doc-files/ValueBased.html">value-based</a>
class; use of identity-sensitive operations (including reference equality
(<code>==</code>), identity hash code, or synchronization) on instances of
<code>Instant</code> may have unpredictable results and should be avoided.
The <code>equals</code> method should be used for comparisons.</div>
<dl>
<dt><span class="simpleTagLabel">Implementation Requirements:</span></dt>
<dd>This class is immutable and thread-safe.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>1.8</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="../../../serialized-form.html#java.time.Instant">Serialized Form</a></dd>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<div class="memberSummary">
<table>
<caption><span>Fields</span><span class="tabEnd"> </span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colSecond" scope="col">Field</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#EPOCH">EPOCH</a></span></code></th>
<td class="colLast">
<div class="block">Constant for the 1970-01-01T00:00:00Z epoch instant.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#MAX">MAX</a></span></code></th>
<td class="colLast">
<div class="block">The maximum supported <code>Instant</code>, '1000000000-12-31T23:59:59.999999999Z'.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#MIN">MIN</a></span></code></th>
<td class="colLast">
<div class="block">The minimum supported <code>Instant</code>, '-1000000000-01-01T00:00Z'.</div>
</td>
</tr>
</tbody>
</table>
</div>
</li>
</ul>
</section>
<!-- ========== METHOD SUMMARY =========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<div class="memberSummary">
<div role="tablist" aria-orientation="horizontal"><button role="tab" aria-selected="true" aria-controls="memberSummary_tabpanel" tabindex="0" onkeydown="switchTab(event)" id="t0" class="activeTableTab">All Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t1" class="tableTab" onclick="show(1);">Static Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t2" class="tableTab" onclick="show(2);">Instance Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t4" class="tableTab" onclick="show(8);">Concrete Methods</button></div>
<div id="memberSummary_tabpanel" role="tabpanel">
<table aria-labelledby="t0">
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colSecond" scope="col">Method</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tbody>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#adjustInto(java.time.temporal.Temporal)">adjustInto</a></span>​(<a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a> temporal)</code></th>
<td class="colLast">
<div class="block">Adjusts the specified temporal object to have this instant.</div>
</td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="OffsetDateTime.html" title="class in java.time">OffsetDateTime</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#atOffset(java.time.ZoneOffset)">atOffset</a></span>​(<a href="ZoneOffset.html" title="class in java.time">ZoneOffset</a> offset)</code></th>
<td class="colLast">
<div class="block">Combines this instant with an offset to create an <code>OffsetDateTime</code>.</div>
</td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="ZonedDateTime.html" title="class in java.time">ZonedDateTime</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#atZone(java.time.ZoneId)">atZone</a></span>​(<a href="ZoneId.html" title="class in java.time">ZoneId</a> zone)</code></th>
<td class="colLast">
<div class="block">Combines this instant with a time-zone to create a <code>ZonedDateTime</code>.</div>
</td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>int</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#compareTo(java.time.Instant)">compareTo</a></span>​(<a href="Instant.html" title="class in java.time">Instant</a> otherInstant)</code></th>
<td class="colLast">
<div class="block">Compares this instant to the specified instant.</div>
</td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#equals(java.lang.Object)">equals</a></span>​(<a href="../lang/Object.html" title="class in java.lang">Object</a> otherInstant)</code></th>
<td class="colLast">
<div class="block">Checks if this instant is equal to the specified instant.</div>
</td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#from(java.time.temporal.TemporalAccessor)">from</a></span>​(<a href="temporal/TemporalAccessor.html" title="interface in java.time.temporal">TemporalAccessor</a> temporal)</code></th>
<td class="colLast">
<div class="block">Obtains an instance of <code>Instant</code> from a temporal object.</div>
</td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>int</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#get(java.time.temporal.TemporalField)">get</a></span>​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</code></th>
<td class="colLast">
<div class="block">Gets the value of the specified field from this instant as an <code>int</code>.</div>
</td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>long</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getEpochSecond()">getEpochSecond</a></span>()</code></th>
<td class="colLast">
<div class="block">Gets the number of seconds from the Java epoch of 1970-01-01T00:00:00Z.</div>
</td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>long</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getLong(java.time.temporal.TemporalField)">getLong</a></span>​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</code></th>
<td class="colLast">
<div class="block">Gets the value of the specified field from this instant as a <code>long</code>.</div>
</td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>int</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getNano()">getNano</a></span>()</code></th>
<td class="colLast">
<div class="block">Gets the number of nanoseconds, later along the time-line, from the start
of the second.</div>
</td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>int</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#hashCode()">hashCode</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns a hash code for this instant.</div>
</td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#isAfter(java.time.Instant)">isAfter</a></span>​(<a href="Instant.html" title="class in java.time">Instant</a> otherInstant)</code></th>
<td class="colLast">
<div class="block">Checks if this instant is after the specified instant.</div>
</td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#isBefore(java.time.Instant)">isBefore</a></span>​(<a href="Instant.html" title="class in java.time">Instant</a> otherInstant)</code></th>
<td class="colLast">
<div class="block">Checks if this instant is before the specified instant.</div>
</td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#isSupported(java.time.temporal.TemporalField)">isSupported</a></span>​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</code></th>
<td class="colLast">
<div class="block">Checks if the specified field is supported.</div>
</td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>boolean</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#isSupported(java.time.temporal.TemporalUnit)">isSupported</a></span>​(<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</code></th>
<td class="colLast">
<div class="block">Checks if the specified unit is supported.</div>
</td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#minus(long,java.time.temporal.TemporalUnit)">minus</a></span>​(long amountToSubtract,
<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified amount subtracted.</div>
</td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#minus(java.time.temporal.TemporalAmount)">minus</a></span>​(<a href="temporal/TemporalAmount.html" title="interface in java.time.temporal">TemporalAmount</a> amountToSubtract)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified amount subtracted.</div>
</td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#minusMillis(long)">minusMillis</a></span>​(long millisToSubtract)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in milliseconds subtracted.</div>
</td>
</tr>
<tr class="altColor" id="i18">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#minusNanos(long)">minusNanos</a></span>​(long nanosToSubtract)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in nanoseconds subtracted.</div>
</td>
</tr>
<tr class="rowColor" id="i19">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#minusSeconds(long)">minusSeconds</a></span>​(long secondsToSubtract)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in seconds subtracted.</div>
</td>
</tr>
<tr class="altColor" id="i20">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#now()">now</a></span>()</code></th>
<td class="colLast">
<div class="block">Obtains the current instant from the system clock.</div>
</td>
</tr>
<tr class="rowColor" id="i21">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#now(java.time.Clock)">now</a></span>​(<a href="Clock.html" title="class in java.time">Clock</a> clock)</code></th>
<td class="colLast">
<div class="block">Obtains the current instant from the specified clock.</div>
</td>
</tr>
<tr class="altColor" id="i22">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#ofEpochMilli(long)">ofEpochMilli</a></span>​(long epochMilli)</code></th>
<td class="colLast">
<div class="block">Obtains an instance of <code>Instant</code> using milliseconds from the
epoch of 1970-01-01T00:00:00Z.</div>
</td>
</tr>
<tr class="rowColor" id="i23">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#ofEpochSecond(long)">ofEpochSecond</a></span>​(long epochSecond)</code></th>
<td class="colLast">
<div class="block">Obtains an instance of <code>Instant</code> using seconds from the
epoch of 1970-01-01T00:00:00Z.</div>
</td>
</tr>
<tr class="altColor" id="i24">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#ofEpochSecond(long,long)">ofEpochSecond</a></span>​(long epochSecond,
long nanoAdjustment)</code></th>
<td class="colLast">
<div class="block">Obtains an instance of <code>Instant</code> using seconds from the
epoch of 1970-01-01T00:00:00Z and nanosecond fraction of second.</div>
</td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code>static <a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#parse(java.lang.CharSequence)">parse</a></span>​(<a href="../lang/CharSequence.html" title="interface in java.lang">CharSequence</a> text)</code></th>
<td class="colLast">
<div class="block">Obtains an instance of <code>Instant</code> from a text string such as
<code>2007-12-03T10:15:30.00Z</code>.</div>
</td>
</tr>
<tr class="altColor" id="i26">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#plus(long,java.time.temporal.TemporalUnit)">plus</a></span>​(long amountToAdd,
<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified amount added.</div>
</td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#plus(java.time.temporal.TemporalAmount)">plus</a></span>​(<a href="temporal/TemporalAmount.html" title="interface in java.time.temporal">TemporalAmount</a> amountToAdd)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified amount added.</div>
</td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#plusMillis(long)">plusMillis</a></span>​(long millisToAdd)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in milliseconds added.</div>
</td>
</tr>
<tr class="rowColor" id="i29">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#plusNanos(long)">plusNanos</a></span>​(long nanosToAdd)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in nanoseconds added.</div>
</td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#plusSeconds(long)">plusSeconds</a></span>​(long secondsToAdd)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified duration in seconds added.</div>
</td>
</tr>
<tr class="rowColor" id="i31">
<td class="colFirst"><code><R> R</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#query(java.time.temporal.TemporalQuery)">query</a></span>​(<a href="temporal/TemporalQuery.html" title="interface in java.time.temporal">TemporalQuery</a><R> query)</code></th>
<td class="colLast">
<div class="block">Queries this instant using the specified query.</div>
</td>
</tr>
<tr class="altColor" id="i32">
<td class="colFirst"><code><a href="temporal/ValueRange.html" title="class in java.time.temporal">ValueRange</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#range(java.time.temporal.TemporalField)">range</a></span>​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</code></th>
<td class="colLast">
<div class="block">Gets the range of valid values for the specified field.</div>
</td>
</tr>
<tr class="rowColor" id="i33">
<td class="colFirst"><code>long</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#toEpochMilli()">toEpochMilli</a></span>()</code></th>
<td class="colLast">
<div class="block">Converts this instant to the number of milliseconds from the epoch
of 1970-01-01T00:00:00Z.</div>
</td>
</tr>
<tr class="altColor" id="i34">
<td class="colFirst"><code><a href="../lang/String.html" title="class in java.lang">String</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#toString()">toString</a></span>()</code></th>
<td class="colLast">
<div class="block">A string representation of this instant using ISO-8601 representation.</div>
</td>
</tr>
<tr class="rowColor" id="i35">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#truncatedTo(java.time.temporal.TemporalUnit)">truncatedTo</a></span>​(<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this <code>Instant</code> truncated to the specified unit.</div>
</td>
</tr>
<tr class="altColor" id="i36">
<td class="colFirst"><code>long</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#until(java.time.temporal.Temporal,java.time.temporal.TemporalUnit)">until</a></span>​(<a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a> endExclusive,
<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</code></th>
<td class="colLast">
<div class="block">Calculates the amount of time until another instant in terms of the specified unit.</div>
</td>
</tr>
<tr class="rowColor" id="i37">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#with(java.time.temporal.TemporalAdjuster)">with</a></span>​(<a href="temporal/TemporalAdjuster.html" title="interface in java.time.temporal">TemporalAdjuster</a> adjuster)</code></th>
<td class="colLast">
<div class="block">Returns an adjusted copy of this instant.</div>
</td>
</tr>
<tr class="altColor" id="i38">
<td class="colFirst"><code><a href="Instant.html" title="class in java.time">Instant</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#with(java.time.temporal.TemporalField,long)">with</a></span>​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field,
long newValue)</code></th>
<td class="colLast">
<div class="block">Returns a copy of this instant with the specified field set to a new value.</div>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods declared in class java.lang.<a href="../lang/Object.html" title="class in java.lang">Object</a></h3>
<code><a href="../lang/Object.html#clone()">clone</a>, <a href="../lang/Object.html#finalize()">finalize</a>, <a href="../lang/Object.html#getClass()">getClass</a>, <a href="../lang/Object.html#notify()">notify</a>, <a href="../lang/Object.html#notifyAll()">notifyAll</a>, <a href="../lang/Object.html#wait()">wait</a>, <a href="../lang/Object.html#wait(long)">wait</a>, <a href="../lang/Object.html#wait(long,int)">wait</a></code></li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="field.detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a id="EPOCH">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>EPOCH</h4>
<pre>public static final <a href="Instant.html" title="class in java.time">Instant</a> EPOCH</pre>
<div class="block">Constant for the 1970-01-01T00:00:00Z epoch instant.</div>
</li>
</ul>
<a id="MIN">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>MIN</h4>
<pre>public static final <a href="Instant.html" title="class in java.time">Instant</a> MIN</pre>
<div class="block">The minimum supported <code>Instant</code>, '-1000000000-01-01T00:00Z'.
This could be used by an application as a "far past" instant.
<p>
This is one year earlier than the minimum <code>LocalDateTime</code>.
This provides sufficient values to handle the range of <code>ZoneOffset</code>
which affect the instant in addition to the local date-time.
The value is also chosen such that the value of the year fits in
an <code>int</code>.</div>
</li>
</ul>
<a id="MAX">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>MAX</h4>
<pre>public static final <a href="Instant.html" title="class in java.time">Instant</a> MAX</pre>
<div class="block">The maximum supported <code>Instant</code>, '1000000000-12-31T23:59:59.999999999Z'.
This could be used by an application as a "far future" instant.
<p>
This is one year later than the maximum <code>LocalDateTime</code>.
This provides sufficient values to handle the range of <code>ZoneOffset</code>
which affect the instant in addition to the local date-time.
The value is also chosen such that the value of the year fits in
an <code>int</code>.</div>
</li>
</ul>
</li>
</ul>
</section>
<!-- ============ METHOD DETAIL ========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a id="now()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>now</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> now()</pre>
<div class="block">Obtains the current instant from the system clock.
<p>
This will query the <a href="Clock.html#systemUTC()"><code>system UTC clock</code></a> to
obtain the current instant.
<p>
Using this method will prevent the ability to use an alternate time-source for
testing because the clock is effectively hard-coded.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the current instant using the system clock, not null</dd>
</dl>
</li>
</ul>
<a id="now(java.time.Clock)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>now</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> now​(<a href="Clock.html" title="class in java.time">Clock</a> clock)</pre>
<div class="block">Obtains the current instant from the specified clock.
<p>
This will query the specified clock to obtain the current time.
<p>
Using this method allows the use of an alternate clock for testing.
The alternate clock may be introduced using <a href="Clock.html" title="class in java.time"><code>dependency injection</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>clock</code> - the clock to use, not null</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the current instant, not null</dd>
</dl>
</li>
</ul>
<a id="ofEpochSecond(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>ofEpochSecond</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> ofEpochSecond​(long epochSecond)</pre>
<div class="block">Obtains an instance of <code>Instant</code> using seconds from the
epoch of 1970-01-01T00:00:00Z.
<p>
The nanosecond field is set to zero.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>epochSecond</code> - the number of seconds from 1970-01-01T00:00:00Z</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an instant, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DateTimeException.html" title="class in java.time">DateTimeException</a></code> - if the instant exceeds the maximum or minimum instant</dd>
</dl>
</li>
</ul>
<a id="ofEpochSecond(long,long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>ofEpochSecond</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> ofEpochSecond​(long epochSecond,
long nanoAdjustment)</pre>
<div class="block">Obtains an instance of <code>Instant</code> using seconds from the
epoch of 1970-01-01T00:00:00Z and nanosecond fraction of second.
<p>
This method allows an arbitrary number of nanoseconds to be passed in.
The factory will alter the values of the second and nanosecond in order
to ensure that the stored nanosecond is in the range 0 to 999,999,999.
For example, the following will result in exactly the same instant:
<pre>
Instant.ofEpochSecond(3, 1);
Instant.ofEpochSecond(4, -999_999_999);
Instant.ofEpochSecond(2, 1000_000_001);
</pre></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>epochSecond</code> - the number of seconds from 1970-01-01T00:00:00Z</dd>
<dd><code>nanoAdjustment</code> - the nanosecond adjustment to the number of seconds, positive or negative</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an instant, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DateTimeException.html" title="class in java.time">DateTimeException</a></code> - if the instant exceeds the maximum or minimum instant</dd>
<dd><code><a href="../lang/ArithmeticException.html" title="class in java.lang">ArithmeticException</a></code> - if numeric overflow occurs</dd>
</dl>
</li>
</ul>
<a id="ofEpochMilli(long)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>ofEpochMilli</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> ofEpochMilli​(long epochMilli)</pre>
<div class="block">Obtains an instance of <code>Instant</code> using milliseconds from the
epoch of 1970-01-01T00:00:00Z.
<p>
The seconds and nanoseconds are extracted from the specified milliseconds.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>epochMilli</code> - the number of milliseconds from 1970-01-01T00:00:00Z</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>an instant, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DateTimeException.html" title="class in java.time">DateTimeException</a></code> - if the instant exceeds the maximum or minimum instant</dd>
</dl>
</li>
</ul>
<a id="from(java.time.temporal.TemporalAccessor)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>from</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> from​(<a href="temporal/TemporalAccessor.html" title="interface in java.time.temporal">TemporalAccessor</a> temporal)</pre>
<div class="block">Obtains an instance of <code>Instant</code> from a temporal object.
<p>
This obtains an instant based on the specified temporal.
A <code>TemporalAccessor</code> represents an arbitrary set of date and time information,
which this factory converts to an instance of <code>Instant</code>.
<p>
The conversion extracts the <a href="temporal/ChronoField.html#INSTANT_SECONDS"><code>INSTANT_SECONDS</code></a>
and <a href="temporal/ChronoField.html#NANO_OF_SECOND"><code>NANO_OF_SECOND</code></a> fields.
<p>
This method matches the signature of the functional interface <a href="temporal/TemporalQuery.html" title="interface in java.time.temporal"><code>TemporalQuery</code></a>
allowing it to be used as a query via method reference, <code>Instant::from</code>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>temporal</code> - the temporal object to convert, not null</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the instant, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DateTimeException.html" title="class in java.time">DateTimeException</a></code> - if unable to convert to an <code>Instant</code></dd>
</dl>
</li>
</ul>
<a id="parse(java.lang.CharSequence)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>parse</h4>
<pre class="methodSignature">public static <a href="Instant.html" title="class in java.time">Instant</a> parse​(<a href="../lang/CharSequence.html" title="interface in java.lang">CharSequence</a> text)</pre>
<div class="block">Obtains an instance of <code>Instant</code> from a text string such as
<code>2007-12-03T10:15:30.00Z</code>.
<p>
The string must represent a valid instant in UTC and is parsed using
<a href="format/DateTimeFormatter.html#ISO_INSTANT"><code>DateTimeFormatter.ISO_INSTANT</code></a>.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>text</code> - the text to parse, not null</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the parsed instant, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="format/DateTimeParseException.html" title="class in java.time.format">DateTimeParseException</a></code> - if the text cannot be parsed</dd>
</dl>
</li>
</ul>
<a id="isSupported(java.time.temporal.TemporalField)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isSupported</h4>
<pre class="methodSignature">public boolean isSupported​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</pre>
<div class="block">Checks if the specified field is supported.
<p>
This checks if this instant can be queried for the specified field.
If false, then calling the <a href="#range(java.time.temporal.TemporalField)"><code>range</code></a>,
<a href="#get(java.time.temporal.TemporalField)"><code>get</code></a> and <a href="#with(java.time.temporal.TemporalField,long)"><code>with(TemporalField, long)</code></a>
methods will throw an exception.
<p>
If the field is a <a href="temporal/ChronoField.html" title="enum in java.time.temporal"><code>ChronoField</code></a> then the query is implemented here.
The supported fields are:
<ul>
<li><code>NANO_OF_SECOND</code>
<li><code>MICRO_OF_SECOND</code>
<li><code>MILLI_OF_SECOND</code>
<li><code>INSTANT_SECONDS</code>
</ul>
All other <code>ChronoField</code> instances will return false.
<p>
If the field is not a <code>ChronoField</code>, then the result of this method
is obtained by invoking <code>TemporalField.isSupportedBy(TemporalAccessor)</code>
passing <code>this</code> as the argument.
Whether the field is supported is determined by the field.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="temporal/TemporalAccessor.html#isSupported(java.time.temporal.TemporalField)">isSupported</a></code> in interface <code><a href="temporal/TemporalAccessor.html" title="interface in java.time.temporal">TemporalAccessor</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>field</code> - the field to check, null returns false</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>true if the field is supported on this instant, false if not</dd>
</dl>
</li>
</ul>
<a id="isSupported(java.time.temporal.TemporalUnit)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>isSupported</h4>
<pre class="methodSignature">public boolean isSupported​(<a href="temporal/TemporalUnit.html" title="interface in java.time.temporal">TemporalUnit</a> unit)</pre>
<div class="block">Checks if the specified unit is supported.
<p>
This checks if the specified unit can be added to, or subtracted from, this date-time.
If false, then calling the <a href="#plus(long,java.time.temporal.TemporalUnit)"><code>plus(long, TemporalUnit)</code></a> and
<a href="#minus(long,java.time.temporal.TemporalUnit)"><code>minus</code></a> methods will throw an exception.
<p>
If the unit is a <a href="temporal/ChronoUnit.html" title="enum in java.time.temporal"><code>ChronoUnit</code></a> then the query is implemented here.
The supported units are:
<ul>
<li><code>NANOS</code>
<li><code>MICROS</code>
<li><code>MILLIS</code>
<li><code>SECONDS</code>
<li><code>MINUTES</code>
<li><code>HOURS</code>
<li><code>HALF_DAYS</code>
<li><code>DAYS</code>
</ul>
All other <code>ChronoUnit</code> instances will return false.
<p>
If the unit is not a <code>ChronoUnit</code>, then the result of this method
is obtained by invoking <code>TemporalUnit.isSupportedBy(Temporal)</code>
passing <code>this</code> as the argument.
Whether the unit is supported is determined by the unit.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="temporal/Temporal.html#isSupported(java.time.temporal.TemporalUnit)">isSupported</a></code> in interface <code><a href="temporal/Temporal.html" title="interface in java.time.temporal">Temporal</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>unit</code> - the unit to check, null returns false</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>true if the unit can be added/subtracted, false if not</dd>
</dl>
</li>
</ul>
<a id="range(java.time.temporal.TemporalField)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>range</h4>
<pre class="methodSignature">public <a href="temporal/ValueRange.html" title="class in java.time.temporal">ValueRange</a> range​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</pre>
<div class="block">Gets the range of valid values for the specified field.
<p>
The range object expresses the minimum and maximum valid values for a field.
This instant is used to enhance the accuracy of the returned range.
If it is not possible to return the range, because the field is not supported
or for some other reason, an exception is thrown.
<p>
If the field is a <a href="temporal/ChronoField.html" title="enum in java.time.temporal"><code>ChronoField</code></a> then the query is implemented here.
The <a href="#isSupported(java.time.temporal.TemporalField)"><code>supported fields</code></a> will return
appropriate range instances.
All other <code>ChronoField</code> instances will throw an <code>UnsupportedTemporalTypeException</code>.
<p>
If the field is not a <code>ChronoField</code>, then the result of this method
is obtained by invoking <code>TemporalField.rangeRefinedBy(TemporalAccessor)</code>
passing <code>this</code> as the argument.
Whether the range can be obtained is determined by the field.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="temporal/TemporalAccessor.html#range(java.time.temporal.TemporalField)">range</a></code> in interface <code><a href="temporal/TemporalAccessor.html" title="interface in java.time.temporal">TemporalAccessor</a></code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>field</code> - the field to query the range for, not null</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the range of valid values for the field, not null</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="DateTimeException.html" title="class in java.time">DateTimeException</a></code> - if the range for the field cannot be obtained</dd>
<dd><code><a href="temporal/UnsupportedTemporalTypeException.html" title="class in java.time.temporal">UnsupportedTemporalTypeException</a></code> - if the field is not supported</dd>
</dl>
</li>
</ul>
<a id="get(java.time.temporal.TemporalField)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>get</h4>
<pre class="methodSignature">public int get​(<a href="temporal/TemporalField.html" title="interface in java.time.temporal">TemporalField</a> field)</pre>
<div class="block">Gets the value of the specified field from this instant as an <code>int</code>.
<p>
This queries this instant for the value of the specified field.
The returned value will always be within the valid range of values for the field.
If it is not possible to return the value, because the field is not supported
or for some other reason, an exception is thrown.
<p>