hyTags
HomeHome DocumentationDocumentation

date-time-add

Adds time components to a date and time, returning a new date and time.
Parameter
Type
Description
self
DateTime
The date and time to add to.
year
Number?
The number of years to add. Optional.
month
Number?
The number of months to add. Optional.
day
Number?
The number of days to add. Optional.
hour
Number?
The number of hours to add. Optional.
minute
Number?
The number of minutes to add. Optional.
second
Number?
The number of seconds to add. Optional.
return
dateTime
A new date and time with the specified components added.
Test Case:Add year to datetime
    <div></div>
    
    <date-time-new year="2024" month="6" day="15" hour="14" minute="30" second="45">
    <date-time-add year="1">
    <date-time-get component="year">
    <assert-equal value="2025" type="number">
    
    👆 Try to change something!
  • Test Case:Add month to datetime
      <div></div>
      
      <date-time-new year="2024" month="6" day="15" hour="14" minute="30" second="45">
      <date-time-add month="2">
      <date-time-get component="month">
      <assert-equal value="8" type="number">
      
      👆 Try to change something!
    • Test Case:Add days to datetime
        <div></div>
        
        <date-time-new year="2024" month="6" day="15" hour="14" minute="30" second="45">
        <date-time-add day="10">
        <date-time-get component="day">
        <assert-equal value="25" type="number">
        
        👆 Try to change something!
      • Test Case:Add hours to datetime
          <div></div>
          
          <date-time-new year="2024" month="6" day="15" hour="14" minute="30" second="45">
          <date-time-add hour="3">
          <date-time-get component="hour">
          <assert-equal value="17" type="number">
          
          👆 Try to change something!
        • Test Case:Add months wraps year - month
            <div></div>
            
            <date-time-new year="2024" month="10" day="15">
            <date-time-add month="8">
            <date-time-get component="month">
            <assert-equal value="6" type="number">
            
            👆 Try to change something!
          • Test Case:Add months wraps year - year
              <div></div>
              
              <date-time-new year="2024" month="10" day="15">
              <date-time-add month="8">
              <date-time-get component="year">
              <assert-equal value="2025" type="number">
              
              👆 Try to change something!
            • Test Case:Add days wraps month
                <div></div>
                
                <date-time-new year="2024" month="6" day="25">
                <date-time-add day="10">
                <date-time-get component="month">
                <assert-equal value="7" type="number">
                
                👆 Try to change something!
              • Test Case:Add hours wraps day
                  <div></div>
                  
                  <date-time-new year="2024" month="6" day="15" hour="22">
                  <date-time-add hour="5">
                  <date-time-get component="day">
                  <assert-equal value="16" type="number">
                  
                  👆 Try to change something!
                • Test Case:Add month to end of January - day
                    <div></div>
                    
                    <date-time-new year="2024" month="1" day="31">
                    <date-time-add month="1">
                    <date-time-get component="day">
                    <assert-equal value="2" type="number">
                    
                    👆 Try to change something!
                  • Test Case:Add month to end of January - month
                      <div></div>
                      
                      <date-time-new year="2024" month="1" day="31">
                      <date-time-add month="1">
                      <date-time-get component="month">
                      <assert-equal value="3" type="number">
                      
                      👆 Try to change something!
                    • Test succeeded Test failed