You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					65 lines
				
				2.0 KiB
			
		
		
			
		
	
	
					65 lines
				
				2.0 KiB
			| 
								 
											3 years ago
										 
									 | 
							
								import toDate from '../toDate/index.js';
							 | 
						||
| 
								 | 
							
								import requiredArgs from '../_lib/requiredArgs/index.js';
							 | 
						||
| 
								 | 
							
								/**
							 | 
						||
| 
								 | 
							
								 * @name min
							 | 
						||
| 
								 | 
							
								 * @category Common Helpers
							 | 
						||
| 
								 | 
							
								 * @summary Return the earliest of the given dates.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * @description
							 | 
						||
| 
								 | 
							
								 * Return the earliest of the given dates.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * ### v2.0.0 breaking changes:
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * - [Changes that are common for the whole library](https://github.com/date-fns/date-fns/blob/master/docs/upgradeGuide.md#Common-Changes).
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * - `min` function now accepts an array of dates rather than spread arguments.
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 *   ```javascript
							 | 
						||
| 
								 | 
							
								 *   // Before v2.0.0
							 | 
						||
| 
								 | 
							
								 *   var date1 = new Date(1989, 6, 10)
							 | 
						||
| 
								 | 
							
								 *   var date2 = new Date(1987, 1, 11)
							 | 
						||
| 
								 | 
							
								 *   var minDate = min(date1, date2)
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 *   // v2.0.0 onward:
							 | 
						||
| 
								 | 
							
								 *   var dates = [new Date(1989, 6, 10), new Date(1987, 1, 11)]
							 | 
						||
| 
								 | 
							
								 *   var minDate = min(dates)
							 | 
						||
| 
								 | 
							
								 *   ```
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * @param {Date[]|Number[]} datesArray - the dates to compare
							 | 
						||
| 
								 | 
							
								 * @returns {Date} the earliest of the dates
							 | 
						||
| 
								 | 
							
								 * @throws {TypeError} 1 argument required
							 | 
						||
| 
								 | 
							
								 *
							 | 
						||
| 
								 | 
							
								 * @example
							 | 
						||
| 
								 | 
							
								 * // Which of these dates is the earliest?
							 | 
						||
| 
								 | 
							
								 * var result = min([
							 | 
						||
| 
								 | 
							
								 *   new Date(1989, 6, 10),
							 | 
						||
| 
								 | 
							
								 *   new Date(1987, 1, 11),
							 | 
						||
| 
								 | 
							
								 *   new Date(1995, 6, 2),
							 | 
						||
| 
								 | 
							
								 *   new Date(1990, 0, 1)
							 | 
						||
| 
								 | 
							
								 * ])
							 | 
						||
| 
								 | 
							
								 * //=> Wed Feb 11 1987 00:00:00
							 | 
						||
| 
								 | 
							
								 */
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								export default function min(dirtyDatesArray) {
							 | 
						||
| 
								 | 
							
								  requiredArgs(1, arguments);
							 | 
						||
| 
								 | 
							
								  var datesArray; // `dirtyDatesArray` is Array, Set or Map, or object with custom `forEach` method
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  if (dirtyDatesArray && typeof dirtyDatesArray.forEach === 'function') {
							 | 
						||
| 
								 | 
							
								    datesArray = dirtyDatesArray; // If `dirtyDatesArray` is Array-like Object, convert to Array.
							 | 
						||
| 
								 | 
							
								  } else if (typeof dirtyDatesArray === 'object' && dirtyDatesArray !== null) {
							 | 
						||
| 
								 | 
							
								    datesArray = Array.prototype.slice.call(dirtyDatesArray);
							 | 
						||
| 
								 | 
							
								  } else {
							 | 
						||
| 
								 | 
							
								    // `dirtyDatesArray` is non-iterable, return Invalid Date
							 | 
						||
| 
								 | 
							
								    return new Date(NaN);
							 | 
						||
| 
								 | 
							
								  }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  var result;
							 | 
						||
| 
								 | 
							
								  datesArray.forEach(function (dirtyDate) {
							 | 
						||
| 
								 | 
							
								    var currentDate = toDate(dirtyDate);
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    if (result === undefined || result > currentDate || isNaN(currentDate)) {
							 | 
						||
| 
								 | 
							
								      result = currentDate;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								  });
							 | 
						||
| 
								 | 
							
								  return result || new Date(NaN);
							 | 
						||
| 
								 | 
							
								}
							 |