Functions/GenXdev.Console/Now.ps1
|
############################################################################### <# .SYNOPSIS Returns the current system date and time as a DateTime object. .DESCRIPTION Provides a simple way to get the current system date and time without any parameters. Returns a standard .NET DateTime object that can be used for datetime calculations, formatting, and comparisons. .LICENSE Copyright (C) 2026 René Vaessen / GenXdev This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>. .EXAMPLE Now Returns the current system date and time as a DateTime object .EXAMPLE $timestamp = Now Stores the current date and time in a variable for later use #> function Now { [CmdletBinding()] [OutputType([System.DateTime])] param() begin { # log function start with verbose output Microsoft.PowerShell.Utility\Write-Verbose 'Starting Now function to retrieve system date and time' } process { # return the current system datetime using .NET DateTime.Now property # this provides high-precision timestamp including date and time return [DateTime]::Now } end { } } |