如何创建System.Single的同义子集类型并实现值类型同款行为？

首先来解答你关于.NET内置值类型（比如System.Single）没有可见构造器和设置方法的疑问：

为什么内置值类型没有公开的构造器/设置方法？ #

其实System.Single这类内置值类型本质是值类型（struct），它们的设计有几个核心关键点：

• 隐式无参构造器：CLR会自动为值类型生成无参构造器，默认把所有字段初始化为0，但在C#里你不能显式定义它（编译器会直接报错）。你平时写float f = default;就是在调用这个隐式构造器。
• 私有字段+不可变设计：像float的实际数值存储在私有字段里，没有公开的设置方法是因为这些类型被设计为不可变的——一旦创建实例，它的值就不能被修改（你看似的“修改”f = 3.14f其实是创建了一个新的实例赋值给变量，而非改变原来的实例）。这种设计让值类型在多线程场景下更安全，也避免了很多意料之外的副作用。
• 直接内存操作：CLR对内置值类型有特殊优化，比如float f = 1.2f;这种赋值是直接操作内存写入数值，不需要通过构造器或方法，这也是它们性能高效的原因之一。

如何创建符合需求的自定义值类型？ #

你想要的是一个仅承载有效时间戳的“受限float”，同时和内置值类型行为一致，这里给你一个完整的实现思路：

1. 定义只读值类型（readonly struct） #

用readonly struct来保证不可变性，和float的行为对齐：

public readonly struct TimestampFloat : IEquatable<TimestampFloat>
{
    // 私有字段存储实际的float值，和System.Single的设计逻辑一致
    private readonly float _value;

    // 显式构造器，只接受通过验证的时间戳值（这里可以替换成你的业务校验规则）
    public TimestampFloat(float validTimestamp)
    {
        // 示例：假设时间戳不能为负数且不能超过某个上限
        if (validTimestamp < 0 || validTimestamp > DateTime.MaxValue.Subtract(new DateTime(1970,1,1)).TotalSeconds)
            throw new ArgumentOutOfRangeException(nameof(validTimestamp), "传入的时间戳无效");
        
        _value = validTimestamp;
    }

    // 提供转换到float的方法，方便和原有逻辑交互
    public float ToFloat() => _value;

    // 重写必要的方法，和内置值类型保持一致的行为
    public override bool Equals(object obj) => obj is TimestampFloat other && Equals(other);
    public bool Equals(TimestampFloat other) => _value.Equals(other._value);
    public override int GetHashCode() => _value.GetHashCode();
    public override string ToString() => _value.ToString();

    // 可选：添加显式转换，既方便和float交互，又能避免隐式转换带来的类型安全问题
    public static explicit operator float(TimestampFloat timestamp) => timestamp._value;
    public static explicit operator TimestampFloat(float value) => new TimestampFloat(value);
}

2. 为自定义类型添加专属扩展方法 #

现在你可以安全地为TimestampFloat添加扩展方法，完全不用担心无效值传入：

public static class TimestampFloatExtensions
{
    public static string FormatAsUtcTime(this TimestampFloat timestamp)
    {
        var epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
        return epoch.AddSeconds(timestamp.ToFloat()).ToString("yyyy-MM-dd HH:mm:ss UTC");
    }

    // 其他你需要的业务扩展方法，比如转换为本地时间、计算时间差等
    public static DateTime ToLocalDateTime(this TimestampFloat timestamp)
    {
        var epoch = new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc);
        return epoch.AddSeconds(timestamp.ToFloat()).ToLocalTime();
    }
}

3. 实际使用方式 #

这样你在处理算法输出时，只有通过验证的float才能转换成TimestampFloat，扩展方法也只能作用于这个类型：

// 假设算法输出的原始float时间戳
float rawTimestamp = 1690000000f;

// 转换成自定义类型（如果无效会直接抛出异常，提前拦截错误）
TimestampFloat validTimestamp = (TimestampFloat)rawTimestamp;

// 调用专属扩展方法
string formattedUtcTime = validTimestamp.FormatAsUtcTime();
DateTime localTime = validTimestamp.ToLocalDateTime();

这样的设计既和内置值类型的不可变行为保持一致，又能确保只有有效的时间戳才能进入你的处理逻辑，完美解决了“不想让无效float调用扩展方法”的问题。

内容的提问来源于stack exchange，提问作者IamIC