Business Scenario

Escenario de negocio

A CSV file contains dates entered in different formats by different users, systems, or exports. Before loading this data into SQL Server or using it in reporting, the dates must be converted into one consistent ISO format.

Un archivo CSV contiene fechas ingresadas en diferentes formatos por distintos usuarios, sistemas o exportaciones. Antes de cargar esta data en SQL Server o usarla en reportes, las fechas deben convertirse a un formato ISO consistente.

Learning Objectives

Objetivos de aprendizaje

• Import a CSV file using PowerShell.
• Detect and convert mixed date formats.
• Create a clean ISO date column for SQL and reporting.
• Preserve invalid values for review instead of silently deleting them.
• Export a clean dataset without overwriting the original file.

• Importar un archivo CSV usando PowerShell.
• Detectar y convertir formatos de fecha mezclados.
• Crear una columna de fecha ISO limpia para SQL y reportes.
• Conservar valores inválidos para revisión en vez de borrarlos silenciosamente.
• Exportar un dataset limpio sin sobrescribir el archivo original.

Sample Input Data

Data de entrada de ejemplo

EmployeeID,Name,HireDate
1001,Juan Carballo,01/15/2026
1002,Maria Lopez,15/01/2026
1003,Pedro Martinez,2026-01-15
1004,Ana Torres,2026.01.15
1005,Luis Perez,invalid-date

Step 1 — Define Source and Output Files

Paso 1 — Definir archivos de entrada y salida

$sourceFile = "C:\Training\dates_raw.csv"
$outputFile = "C:\Training\dates_clean.csv"

Step 2 — Import the CSV File

Paso 2 — Importar el archivo CSV

$records = Import-Csv -Path $sourceFile

Step 3 — Define Accepted Date Formats

Paso 3 — Definir formatos de fecha aceptados

$dateFormats = @(
    "MM/dd/yyyy",
    "dd/MM/yyyy",
    "yyyy-MM-dd",
    "yyyy.MM.dd"
)

Step 4 — Normalize the Date Column

Paso 4 — Normalizar la columna de fecha

$records | ForEach-Object {
    $parsedDate = $null

    if ([datetime]::TryParseExact(
        $_.HireDate,
        $dateFormats,
        $null,
        [System.Globalization.DateTimeStyles]::None,
        [ref]$parsedDate
    )) {
        $_ | Add-Member -NotePropertyName "HireDate_ISO" -NotePropertyValue $parsedDate.ToString("yyyy-MM-dd") -Force
        $_ | Add-Member -NotePropertyName "Date_Status" -NotePropertyValue "Valid" -Force
    }
    else {
        $_ | Add-Member -NotePropertyName "HireDate_ISO" -NotePropertyValue "" -Force
        $_ | Add-Member -NotePropertyName "Date_Status" -NotePropertyValue "Review" -Force
    }
}

Step 5 — Export the Clean File

Paso 5 — Exportar el archivo limpio

$records | Export-Csv -Path $outputFile -NoTypeInformation -Encoding UTF8

Complete Script

Script completo

$sourceFile = "C:\Training\dates_raw.csv"
$outputFile = "C:\Training\dates_clean.csv"

$dateFormats = @(
    "MM/dd/yyyy",
    "dd/MM/yyyy",
    "yyyy-MM-dd",
    "yyyy.MM.dd"
)

$records = Import-Csv -Path $sourceFile

$records | ForEach-Object {
    $parsedDate = $null

    if ([datetime]::TryParseExact(
        $_.HireDate,
        $dateFormats,
        $null,
        [System.Globalization.DateTimeStyles]::None,
        [ref]$parsedDate
    )) {
        $_ | Add-Member -NotePropertyName "HireDate_ISO" -NotePropertyValue $parsedDate.ToString("yyyy-MM-dd") -Force
        $_ | Add-Member -NotePropertyName "Date_Status" -NotePropertyValue "Valid" -Force
    }
    else {
        $_ | Add-Member -NotePropertyName "HireDate_ISO" -NotePropertyValue "" -Force
        $_ | Add-Member -NotePropertyName "Date_Status" -NotePropertyValue "Review" -Force
    }
}

$records | Export-Csv -Path $outputFile -NoTypeInformation -Encoding UTF8

Expected Result

Resultado esperado

Validation Checklist

Lista de validación

• The original file remains unchanged.
• Valid date values are converted to ISO format.
• Invalid dates are flagged for review.
• The clean date column can be used for SQL loading, filtering, sorting, and reporting.
• The process can be expanded with additional accepted formats when needed.

• El archivo original permanece sin cambios.
• Las fechas válidas se convierten al formato ISO.
• Las fechas inválidas quedan marcadas para revisión.
• La columna limpia puede usarse para cargas SQL, filtros, ordenamiento y reportes.
• El proceso puede ampliarse con formatos adicionales cuando sea necesario.

Professional Notes

Notas profesionales

Date normalization is essential before database imports, ETL processes, dashboard development, and audit reporting. When dates come from multiple sources, never assume one format. Validate explicitly and keep rejected values visible for review.

La normalización de fechas es esencial antes de importaciones a bases de datos, procesos ETL, dashboards y reportes de auditoría. Cuando las fechas vienen de múltiples fuentes, nunca asumas un solo formato. Valida explícitamente y conserva los valores rechazados para revisión.