update documentation

Author: mdowst

README.md

@@ -13,6 +13,7 @@ Install-Module PSDates
 | Cmdlet | Synopsis |
 | ------ | -------- |
 | [Convert-TimeZone](docs/Convert-TimeZone.md) | Convert a datetime value from one time zone to another |
+| [Convert-ToDateTime](docs/Convert-ToDateTime.md) | Converts various input objects to a DateTime object. |
 | [ConvertFrom-UnixTime](docs/ConvertFrom-UnixTime.md) | Converts a Unix Time value to a datetime value |
 | [ConvertFrom-WmiDateTime](docs/ConvertFrom-WmiDateTime.md) | Converts a Wmi Time value to a datetime value |
 | [ConvertTo-UnixTime](docs/ConvertTo-UnixTime.md) | Converts a datetime value to Unix Time |
@@ -25,6 +26,8 @@ Install-Module PSDates
 | [Get-Easter](docs/Get-Easter.md) | This function offers a generic Easter computing method for any given year, using Western, Orthodox or Julian algorithms. |
 | [Get-PatchTuesday](docs/Get-PatchTuesday.md) | Returns the second Tuesday of the month |
 | [Get-SunTime](docs/Get-SunTime.md) | Find sunrise and sunset times for any location on planet Earth. |
+| [Group-TimeSpan](docs/Group-TimeSpan.md) | Groups objects by a specified time span. |
+| [Measure-TimeSpan](docs/Measure-TimeSpan.md) | Measures statistical properties (such as sum, average, and maximum) of a specified property within grouped time spans. |
 | [New-Duration](docs/New-Duration.md) | Calculates the time span between two dates and returns the duration in the ISO 8601 format |
 | [Test-CrontabSchedule](docs/Test-CrontabSchedule.md) | Tests that a crontab string is valid |
 

docs/Convert-ToDateTime.md

@@ -0,0 +1,111 @@
+---
+external help file: PSDates-help.xml
+Module Name: PSDates
+online version: 
+schema: 2.0.0
+---
+
+# Convert-ToDateTime
+
+## SYNOPSIS
+
+Converts various input objects to a DateTime object.
+
+## SYNTAX
+
+### __AllParameterSets
+
+```
+Convert-ToDateTime [-InputObject] <Object> [-ProgressAction <ActionPreference>] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+The `Convert-ToDateTime` function attempts to convert different types of input objects into a DateTime object.
+It supports input from various data types such as strings and objects that can be cast or converted to a DateTime.
+
+
+## EXAMPLES
+
+### Example 1: EXAMPLE 1
+
+```
+'2024-08-29' | Convert-ToDateTime
+```
+
+Converts the string '2024-08-29' into a DateTime object representing the 29th of August, 2024.
+
+
+
+
+
+
+## PARAMETERS
+
+### -InputObject
+
+Specifies the input object to be converted to a DateTime.
+This parameter accepts pipeline input and is mandatory.
+
+The input can be of any type:
+- If the input is already a DateTime, it will be returned as-is.
+- If the input is a string, it attempts to parse it into a DateTime.
+- Other input types will be processed accordingly, if possible.
+
+```yaml
+Type: Object
+Parameter Sets: (All)
+Aliases: 
+Accepted values: 
+
+Required: True (All) False (None)
+Position: 0
+Default value: 
+Accept pipeline input: True
+Accept wildcard characters: False
+DontShow: False
+```
+
+### -ProgressAction
+
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+Accepted values: 
+
+Required: True (None) False (All)
+Position: Named
+Default value: 
+Accept pipeline input: False
+Accept wildcard characters: False
+DontShow: False
+```
+
+
+### CommonParameters
+
+This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
+
+## INPUTS
+
+### System.Object
+The function accepts objects from the pipeline, which are attempted to be converted to DateTime.
+
+
+## OUTPUTS
+
+### System.DateTime
+The function outputs a DateTime object if the conversion is successful.
+
+
+## NOTES
+
+
+
+## RELATED LINKS
+
+Fill Related Links Here
+

docs/Get-SunTime.md

@@ -16,7 +16,7 @@ Find sunrise and sunset times for any location on planet Earth.
 ### __AllParameterSets
 
 ```
-Get-SunTime [[-Date <DateTime>]] [[-Latitude <Double>]] [[-Longitude <Double>]] [[-Elevation <Double>]] [[-TimeZone <TimeZoneInfo>]] [-ProgressAction <ActionPreference>] [<CommonParameters>]
+Get-SunTime [[-Date <DateTime>]] [-Latitude] <Double> [-Longitude] <Double> [[-Elevation <Double>]] [[-TimeZone <String>]] [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -102,7 +102,7 @@ Parameter Sets: (All)
 Aliases: 
 Accepted values: 
 
-Required: True (None) False (All)
+Required: True (All) False (None)
 Position: 1
 Default value: 0
 Accept pipeline input: False
@@ -120,7 +120,7 @@ Parameter Sets: (All)
 Aliases: 
 Accepted values: 
 
-Required: True (None) False (All)
+Required: True (All) False (None)
 Position: 2
 Default value: 0
 Accept pipeline input: False
@@ -151,7 +151,7 @@ DontShow: False
 The time zone for the final results
 
 ```yaml
-Type: TimeZoneInfo
+Type: String
 Parameter Sets: (All)
 Aliases: 
 Accepted values: